0:{"P":null,"b":"bSVAZYDWZGnoPCVURCV1D","p":"","c":["","posts","spring-gateway-migrate-from-mvc-to-server-webmvc",""],"i":false,"f":[[["",{"children":["posts",{"children":["spring-gateway-migrate-from-mvc-to-server-webmvc",{"children":["__PAGE__",{}]}]}]},"$undefined","$undefined",true],["",["$","$1","c",{"children":[[["$","link","0",{"rel":"stylesheet","href":"/_next/static/css/543014fc3b65910c.css","precedence":"next","crossOrigin":"$undefined","nonce":"$undefined"}],["$","link","1",{"rel":"stylesheet","href":"/_next/static/css/0bce41b1d5630b99.css","precedence":"next","crossOrigin":"$undefined","nonce":"$undefined"}]],["$","$L2",null,{"children":["$","$L3",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$L4",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":[["$","div",null,{"className":"flex flex-col items-center justify-center min-h-[60vh] text-center px-4m mx-auto","children":[["$","div",null,{"className":"mb-8","children":["$","h1",null,{"className":"text-9xl font-bold text-muted-foreground select-none","children":"404"}]}],["$","div",null,{"className":"mb-8 max-w-md","children":[["$","h2",null,{"className":"text-2xl font-bold mb-4","children":"Page Not Found"}],["$","p",null,{"className":"text-muted-foreground leading-relaxed","children":"Sorry, the page you're looking for doesn't exist or has been moved. Let's get you back on track."}]]}],["$","div",null,{"className":"flex flex-col sm:flex-row gap-4 mb-8","children":["$","$L5",null,{"href":"/","children":["$","button",null,{"data-slot":"button","className":"inline-flex items-center justify-center gap-2 whitespace-nowrap text-sm font-medium transition-all disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4 shrink-0 [&_svg]:shrink-0 outline-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive bg-primary text-primary-foreground shadow-xs hover:bg-primary/90 h-10 rounded-md px-6 has-[>svg]:px-4","children":[["$","svg",null,{"ref":"$undefined","xmlns":"http://www.w3.org/2000/svg","width":24,"height":24,"viewBox":"0 0 24 24","fill":"none","stroke":"currentColor","strokeWidth":2,"strokeLinecap":"round","strokeLinejoin":"round","className":"lucide lucide-house","children":[["$","path","5wwlr5",{"d":"M15 21v-8a1 1 0 0 0-1-1h-4a1 1 0 0 0-1 1v8"}],["$","path","1d0kgt",{"d":"M3 10a2 2 0 0 1 .709-1.528l7-5.999a2 2 0 0 1 2.582 0l7 5.999A2 2 0 0 1 21 10v9a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z"}],"$undefined"]}],"Go Home"]}]}]}],["$","div",null,{"className":"w-full max-w-md","children":[["$","h3",null,{"className":"text-sm font-medium text-muted-foreground mb-4","children":"Popular Pages"}],["$","div",null,{"className":"grid grid-cols-1 sm:grid-cols-2 gap-3 text-sm","children":[["$","$L5",null,{"href":"/tools","className":"flex items-center gap-2 p-3 rounded-lg border border-border hover:bg-accent transition-colors","children":[["$","svg",null,{"ref":"$undefined","xmlns":"http://www.w3.org/2000/svg","width":24,"height":24,"viewBox":"0 0 24 24","fill":"none","stroke":"currentColor","strokeWidth":2,"strokeLinecap":"round","strokeLinejoin":"round","className":"lucide lucide-search","children":[["$","circle","4ej97u",{"cx":"11","cy":"11","r":"8"}],["$","path","1qie3q",{"d":"m21 21-4.3-4.3"}],"$undefined"]}],"Tools"]}],["$","$L5",null,{"href":"/posts","className":"flex items-center gap-2 p-3 rounded-lg border border-border hover:bg-accent transition-colors","children":[["$","svg",null,{"ref":"$undefined","xmlns":"http://www.w3.org/2000/svg","width":24,"height":24,"viewBox":"0 0 24 24","fill":"none","stroke":"currentColor","strokeWidth":2,"strokeLinecap":"round","strokeLinejoin":"round","className":"lucide lucide-file-text","children":[["$","path","1rqfz7",{"d":"M15 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7Z"}],["$","path","tnqrlb",{"d":"M14 2v4a2 2 0 0 0 2 2h4"}],["$","path","b1mrlr",{"d":"M10 9H8"}],["$","path","t4e002",{"d":"M16 13H8"}],["$","path","z1uh3a",{"d":"M16 17H8"}],"$undefined"]}],"Articles"]}]]}]]}]]}],[]],"forbidden":"$undefined","unauthorized":"$undefined"}]}]]}],{"children":["posts",["$","$1","c",{"children":[null,["$","$L3",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$L4",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":"$undefined","forbidden":"$undefined","unauthorized":"$undefined"}]]}],{"children":["spring-gateway-migrate-from-mvc-to-server-webmvc",["$","$1","c",{"children":[null,["$","$L3",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$L4",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":"$undefined","forbidden":"$undefined","unauthorized":"$undefined"}]]}],{"children":["__PAGE__",["$","$1","c",{"children":[["$","div",null,{"className":"max-w-full grid grid-cols-1 lg:grid-cols-12 gap-x-8","children":[["$","div",null,{"className":"max-w-full lg:col-span-8","children":[["$","img",null,{"src":"/assets/images/2025-07-03-spring-gateway-migrate-from-mvc-to-server-webmvc/thumbnail.jpg","className":"w-full mb-6 rounded-lg object-cover"}],["$","div",null,{"className":"text-align-start max-w-full \n prose prose-headings:mt-8 prose-headings:font-semibold \n prose-h1:text-4xl prose-h2:text-3xl prose-h3:text-2xl \n prose-h4:text-xl prose-h5:text-lg prose-h6:text-base \n dark:prose-invert prose-code:before:content-none prose-code:after:content-none","children":[["$","h1",null,{"children":"Migrating from Spring Cloud Gateway MVC to Server Web MVC (2025.0.0+)"}],"\n",["$","p",null,{"children":["As of Spring Cloud version ",["$","code",null,{"children":"2025.0.0"}],", the Spring Cloud Gateway MVC project has been officially deprecated. It will be removed in future releases and has been replaced by ",["$","strong",null,{"children":"Spring Cloud Gateway Server Web MVC"}],"."]}],"\n",["$","p",null,{"children":["If you're maintaining a Spring Boot project using the Gateway MVC module, it's important to migrate to the new ",["$","code",null,{"children":"server-webmvc"}]," module to ensure ongoing compatibility and access to future improvements. This guide walks through the steps required to perform the migration while preserving existing functionality."]}],"\n",["$","hr",null,{}],"\n",["$","h2",null,{"children":"1. Update Project Dependencies"}],"\n",["$","p",null,{"children":"First, update your Maven configuration to use the latest Spring Cloud BOM."}],"\n",["$","h3",null,{"children":"Add Spring Cloud dependency management"}],"\n",["$","p",null,{"children":["In your ",["$","code",null,{"children":"pom.xml"}],":"]}],"\n",["$","$L6",null,{"children":["$","code",null,{"className":"hljs language-xml","children":[["$","span",null,{"className":"hljs-tag","children":["<",["$","span",null,{"className":"hljs-name","children":"dependencyManagement"}],">"]}],"\n ",["$","span",null,{"className":"hljs-tag","children":["<",["$","span",null,{"className":"hljs-name","children":"dependencies"}],">"]}],"\n ",["$","span",null,{"className":"hljs-tag","children":["<",["$","span",null,{"className":"hljs-name","children":"dependency"}],">"]}],"\n ",["$","span",null,{"className":"hljs-tag","children":["<",["$","span",null,{"className":"hljs-name","children":"groupId"}],">"]}],"org.springframework.cloud",["$","span",null,{"className":"hljs-tag","children":[""]}],"\n ",["$","span",null,{"className":"hljs-tag","children":["<",["$","span",null,{"className":"hljs-name","children":"artifactId"}],">"]}],"spring-cloud-dependencies",["$","span",null,{"className":"hljs-tag","children":[""]}],"\n ",["$","span",null,{"className":"hljs-tag","children":["<",["$","span",null,{"className":"hljs-name","children":"version"}],">"]}],"2025.0.0",["$","span",null,{"className":"hljs-tag","children":[""]}],"\n ",["$","span",null,{"className":"hljs-tag","children":["<",["$","span",null,{"className":"hljs-name","children":"type"}],">"]}],"pom",["$","span",null,{"className":"hljs-tag","children":[""]}],"\n ",["$","span",null,{"className":"hljs-tag","children":["<",["$","span",null,{"className":"hljs-name","children":"scope"}],">"]}],"import",["$","span",null,{"className":"hljs-tag","children":[""]}],"\n ",["$","span",null,{"className":"hljs-tag","children":[""]}],"\n ",["$","span",null,{"className":"hljs-tag","children":[""]}],"\n",["$","span",null,{"className":"hljs-tag","children":[""]}],"\n"]}]}],"\n",["$","h3",null,{"children":"Replace the deprecated module"}],"\n",["$","p",null,{"children":"Remove the old Gateway MVC dependency and replace it with the new Server Web MVC module:"}],"\n",["$","$L6",null,{"children":["$","code",null,{"className":"hljs language-xml","children":[["$","span",null,{"className":"hljs-tag","children":["<",["$","span",null,{"className":"hljs-name","children":"dependency"}],">"]}],"\n ",["$","span",null,{"className":"hljs-tag","children":["<",["$","span",null,{"className":"hljs-name","children":"groupId"}],">"]}],"org.springframework.cloud",["$","span",null,{"className":"hljs-tag","children":[""]}],"\n ",["$","span",null,{"className":"hljs-tag","children":["<",["$","span",null,{"className":"hljs-name","children":"artifactId"}],">"]}],"spring-cloud-gateway-server-webmvc",["$","span",null,{"className":"hljs-tag","children":[""]}],"\n",["$","span",null,{"className":"hljs-tag","children":[""]}],"\n"]}]}],"\n",["$","hr",null,{}],"\n",["$","h2",null,{"children":["2. Update ",["$","code",null,{"children":"application.yml"}]," Configuration"]}],"\n",["$","p",null,{"children":"The configuration structure has changed in the new module. Specifically, the prefix for gateway settings is different, and some properties have been reorganized."}],"\n",["$","h3",null,{"children":"Route configuration changes"}],"\n",["$","p",null,{"children":"Previously, routes were defined under:"}],"\n",["$","$L6",null,{"children":["$","code",null,{"className":"hljs language-yaml","children":[["$","span",null,{"className":"hljs-attr","children":"spring:"}],"\n ",["$","span",null,{"className":"hljs-attr","children":"cloud:"}],"\n ",["$","span",null,{"className":"hljs-attr","children":"gateway:"}],"\n ",["$","span",null,{"className":"hljs-attr","children":"mvc:"}],"\n ",["$","span",null,{"className":"hljs-attr","children":"routes:"}],"\n"]}]}],"\n",["$","p",null,{"children":"This now becomes:"}],"\n",["$","$L6",null,{"children":["$","code",null,{"className":"hljs language-yaml","children":[["$","span",null,{"className":"hljs-attr","children":"spring:"}],"\n ",["$","span",null,{"className":"hljs-attr","children":"cloud:"}],"\n ",["$","span",null,{"className":"hljs-attr","children":"gateway:"}],"\n ",["$","span",null,{"className":"hljs-attr","children":"server:"}],"\n ",["$","span",null,{"className":"hljs-attr","children":"webmvc:"}],"\n ",["$","span",null,{"className":"hljs-attr","children":"routes:"}],"\n"]}]}],"\n",["$","p",null,{"children":"Example:"}],"\n",["$","$L6",null,{"children":["$","code",null,{"className":"hljs language-yaml","children":[["$","span",null,{"className":"hljs-attr","children":"spring:"}],"\n ",["$","span",null,{"className":"hljs-attr","children":"cloud:"}],"\n ",["$","span",null,{"className":"hljs-attr","children":"gateway:"}],"\n ",["$","span",null,{"className":"hljs-attr","children":"server:"}],"\n ",["$","span",null,{"className":"hljs-attr","children":"webmvc:"}],"\n ",["$","span",null,{"className":"hljs-attr","children":"routes:"}],"\n ",["$","span",null,{"className":"hljs-bullet","children":"-"}]," ",["$","span",null,{"className":"hljs-attr","children":"id:"}]," ",["$","span",null,{"className":"hljs-string","children":"example"}],"\n ",["$","span",null,{"className":"hljs-attr","children":"uri:"}]," ",["$","span",null,{"className":"hljs-string","children":"http://example.com"}],"\n ",["$","span",null,{"className":"hljs-attr","children":"predicates:"}],"\n ",["$","span",null,{"className":"hljs-bullet","children":"-"}]," ",["$","span",null,{"className":"hljs-string","children":"Path=/example/**"}],"\n ",["$","span",null,{"className":"hljs-attr","children":"filters:"}],"\n ",["$","span",null,{"className":"hljs-bullet","children":"-"}]," ",["$","span",null,{"className":"hljs-string","children":"AddRequestHeader=X-Example-Header,"}]," ",["$","span",null,{"className":"hljs-string","children":"ExampleValue"}],"\n"]}]}],"\n",["$","p",null,{"children":"Make sure all your routes are refactored to match the new structure."}],"\n",["$","hr",null,{}],"\n",["$","h3",null,{"children":"HTTP client configuration changes"}],"\n",["$","p",null,{"children":["In earlier versions, HTTP client settings were nested under the ",["$","code",null,{"children":"mvc"}]," namespace:"]}],"\n",["$","$L6",null,{"children":["$","code",null,{"className":"hljs language-yaml","children":[["$","span",null,{"className":"hljs-attr","children":"spring:"}],"\n ",["$","span",null,{"className":"hljs-attr","children":"cloud:"}],"\n ",["$","span",null,{"className":"hljs-attr","children":"gateway:"}],"\n ",["$","span",null,{"className":"hljs-attr","children":"mvc:"}],"\n ",["$","span",null,{"className":"hljs-attr","children":"http-client:"}],"\n ",["$","span",null,{"className":"hljs-attr","children":"connect-timeout:"}]," ",["$","span",null,{"className":"hljs-number","children":"5000"}],"\n ",["$","span",null,{"className":"hljs-attr","children":"read-timeout:"}]," ",["$","span",null,{"className":"hljs-number","children":"5000"}],"\n"]}]}],"\n",["$","p",null,{"children":["With the new version, they are moved to the top-level ",["$","code",null,{"children":"gateway"}]," configuration:"]}],"\n",["$","$L6",null,{"children":["$","code",null,{"className":"hljs language-yaml","children":[["$","span",null,{"className":"hljs-attr","children":"spring:"}],"\n ",["$","span",null,{"className":"hljs-attr","children":"cloud:"}],"\n ",["$","span",null,{"className":"hljs-attr","children":"gateway:"}],"\n ",["$","span",null,{"className":"hljs-attr","children":"httpclient:"}],"\n ",["$","span",null,{"className":"hljs-attr","children":"connect-timeout:"}]," ",["$","span",null,{"className":"hljs-number","children":"5000"}],"\n ",["$","span",null,{"className":"hljs-attr","children":"read-timeout:"}]," ",["$","span",null,{"className":"hljs-number","children":"5000"}],"\n"]}]}],"\n",["$","p",null,{"children":"Be sure to double-check all configuration keys, as some have been renamed or relocated."}],"\n",["$","hr",null,{}],"\n",["$","h2",null,{"children":"Reference Documentation"}],"\n",["$","p",null,{"children":["For a complete and up-to-date list of supported configuration properties, refer to the official ",["$","a",null,{"href":"https://docs.spring.io/spring-cloud-gateway/reference/appendix.html","children":"Spring Cloud Gateway documentation"}],"."]}],"\n",["$","hr",null,{}],"\n",["$","h2",null,{"children":"Conclusion"}],"\n",["$","p",null,{"children":["The deprecation of Spring Cloud Gateway MVC in version ",["$","code",null,{"children":"2025.0.0"}]," marks a shift toward a more unified and maintainable gateway module. Migrating to Spring Cloud Gateway Server Web MVC ensures your application remains compatible with future versions of Spring Cloud and benefits from continued support and improvements."]}],"\n",["$","p",null,{"children":"By updating your dependencies and adjusting your configuration, you can complete the migration smoothly without changing the core behavior of your gateway routes."}]]}],["$","div",null,{"className":"mt-12 text-sm text-muted-foreground","children":["Last modified: ","July 3, 2025"]}]]}],["$","div",null,{"className":"mt-8 lg:mt-0 lg:col-span-4","children":["$","div",null,{"className":"sticky top-24 flex flex-col gap-6","children":[["$","div",null,{"data-slot":"card","className":"bg-card text-card-foreground flex flex-col gap-6 border w-full mx-auto p-6 rounded-lg shadow-sm","children":["$","form",null,{"action":"https://gmail.us21.list-manage.com/subscribe/post?u=d117eead52e698c6ca007117b&id=ff24061256&f_id=00875ce1f0","method":"post","id":"mc-embedded-subscribe-form","name":"mc-embedded-subscribe-form","target":"_blank","noValidate":true,"className":"space-y-4","children":[["$","div",null,{"data-slot":"card-header","className":"@container/card-header grid auto-rows-min grid-rows-[auto_auto] items-start gap-1.5 px-6 has-[data-slot=card-action]:grid-cols-[1fr_auto] [.border-b]:pb-6 text-center max-w-lg mx-auto","children":[["$","div",null,{"data-slot":"card-title","className":"leading-none font-semibold","children":"Stay in the loop"}],["$","div",null,{"data-slot":"card-description","className":"text-muted-foreground text-sm","children":"Subscribe to our newsletter to get the latest articles delivered to your inbox"}]]}],["$","div",null,{"data-slot":"card-content","className":"px-6 max-w-lg mx-auto","children":[["$","input",null,{"type":"email","data-slot":"input","className":"file:text-foreground placeholder:text-muted-foreground selection:bg-primary selection:text-primary-foreground dark:bg-input/30 border-input flex h-9 min-w-0 rounded-md border bg-transparent px-3 py-1 text-base shadow-xs transition-[color,box-shadow] outline-none file:inline-flex file:h-7 file:border-0 file:bg-transparent file:text-sm file:font-medium disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 md:text-sm focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive w-full","placeholder":"Enter your email address","name":"EMAIL","id":"mce-EMAIL","required":true}],["$","div",null,{"id":"mce-responses","className":"hidden","children":[["$","div",null,{"id":"mce-error-response"}],["$","div",null,{"id":"mce-success-response"}]]}],["$","div",null,{"aria-hidden":"true","className":"absolute left-[-5000px]","children":["$","input",null,{"type":"text","name":"b_d117eead52e698c6ca007117b_ff24061256","tabIndex":-1,"defaultValue":""}]}],["$","button",null,{"data-slot":"button","className":"inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium transition-all disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4 shrink-0 [&_svg]:shrink-0 outline-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive bg-primary text-primary-foreground shadow-xs hover:bg-primary/90 h-9 px-4 py-2 has-[>svg]:px-3 w-full mt-3","id":"mc-embedded-subscribe","type":"submit","children":"Subscribe"}]]}]]}]}],["$","div",null,{"className":"bg-muted rounded-lg p-6 border","children":[["$","h3",null,{"className":"text-center font-semibold mb-4 text-muted-foreground tracking-wide uppercase","children":"Related Articles"}],["$","ul",null,{"className":"space-y-3","children":[[["$","li","how-to-add-recaptcha-validation-filter-on-spring-gateway",{"children":["$","$L5",null,{"href":"/posts/how-to-add-recaptcha-validation-filter-on-spring-gateway","className":"flex items-center gap-2 text-sm text-primary hover:underline hover:text-accent-foreground","children":[["$","div",null,{"className":"mb-auto","children":["$","svg",null,{"ref":"$undefined","xmlns":"http://www.w3.org/2000/svg","width":24,"height":24,"viewBox":"0 0 24 24","fill":"none","stroke":"currentColor","strokeWidth":2,"strokeLinecap":"round","strokeLinejoin":"round","className":"lucide lucide-chevrons-right w-4 h-5 text-muted-foreground","aria-hidden":"true","children":[["$","path","xnjwq",{"d":"m6 17 5-5-5-5"}],["$","path","17xmmf",{"d":"m13 17 5-5-5-5"}],"$undefined"]}]}],["$","span",null,{"children":"How to add a reCAPTCHA Filter to Spring Gateway"}]]}]}]],[["$","li","2025-07-13-deprecated-configuration-property-spring-cloud-gateway-mvc-routes",{"children":["$","$L5",null,{"href":"/issues/2025-07-13-deprecated-configuration-property-spring-cloud-gateway-mvc-routes","className":"flex items-center gap-2 text-sm text-primary hover:underline hover:text-accent-foreground","children":[["$","div",null,{"className":"mb-auto","children":["$","svg",null,{"ref":"$undefined","xmlns":"http://www.w3.org/2000/svg","width":24,"height":24,"viewBox":"0 0 24 24","fill":"none","stroke":"currentColor","strokeWidth":2,"strokeLinecap":"round","strokeLinejoin":"round","className":"lucide lucide-chevrons-right w-4 h-5 text-muted-foreground","aria-hidden":"true","children":[["$","path","xnjwq",{"d":"m6 17 5-5-5-5"}],["$","path","17xmmf",{"d":"m13 17 5-5-5-5"}],"$undefined"]}]}],["$","span",null,{"children":"Deprecated configuration property 'spring.cloud.gateway.mvc.routes'"}]]}]}]]]}]]}]]}]}]]}],"$undefined",[["$","link","0",{"rel":"stylesheet","href":"/_next/static/css/09f398cdd9198ecd.css","precedence":"next","crossOrigin":"$undefined","nonce":"$undefined"}]],["$","$L7",null,{"children":["$L8","$L9",null]}]]}],{},null,false]},null,false]},null,false]},null,false],["$","$1","h",{"children":[null,["$","$1","_2n9YuG8FxnOWFe-Flr04",{"children":[["$","$La",null,{"children":"$Lb"}],["$","meta",null,{"name":"next-size-adjust","content":""}]]}],["$","$Lc",null,{"children":"$Ld"}]]}],false]],"m":"$undefined","G":["$e","$undefined"],"s":false,"S":true}