Breaking Changes
Spring Cloud Gateway
- New Module and Starter names have been created, and the old names are deprecated. The new and deprecated artifacts are listed in the table below #3645. These new names clarify the two styles of gateway (server or proxy exchange) as well as the two web stacks from Spring Framework (Web MCV and WebFlux). Use of the deprecated artifacts will add a warning message in the logs.
Deprecated Artifact | New Artifact |
---|---|
spring-cloud-gateway-server | spring-cloud-gateway-server-webflux |
spring-cloud-gateway-server-mvc | spring-cloud-gateway-server-webmvc |
spring-cloud-starter-gateway-server | spring-cloud-starter-gateway-server-webflux |
spring-cloud-starter-gateway-server-mvc | spring-cloud-starter-gateway-server-webmvc |
spring-cloud-gateway-mvc | spring-cloud-gateway-proxyexchange-webmvc |
spring-cloud-gateway-webflux | spring-cloud-gateway-proxyexchange-webflux |
- Migration to new property prefixes to match the new module names: #3361, #3362, #3363, #3647. Use
spring-boot-properties-migrator
to support the deprecated prefixes. The table below lists the module or starter, its old prefix, and the new replacement prefix.
Module/Starter | Deprecated prefix | New prefix |
---|---|---|
spring-cloud-starter-gateway-server-webflux | spring.cloud.gateway.* | spring.cloud.gateway.server.webflux.* |
spring-cloud-starter-gateway-server-webmvc | spring.cloud.gateway.mvc.* | spring.cloud.gateway.server.webmvc.* |
spring-cloud-gateway-proxyexchange-webflux | spring.cloud.gateway.proxy.* | spring.cloud.gateway.proxy-exchange.webflux.* |
spring-cloud-gateway-proxyexchange-webmvc | spring.cloud.gateway.proxy.* | spring.cloud.gateway.proxy-exchange.webmvc.* |
- The
X-Forwarded-*
andForwarded
header functionality will be disabled by default with the fix versions. If you requireX-Forwarded-*
orForwarded
header functionality, setspring.cloud.gateway.server.webflux.trusted-proxies
to a Java Regular Expression that specifies the proxies whose headers you trust. If you are using Spring Cloud Gateway Server MVC (only available from 4.1.x onward) setspring.cloud.gateway.mvc.trusted-proxies
. For example for Spring Cloud Gateway Server:
spring.cloud.gateway.server.webflux.trusted-proxies=10\.0\.0\..*
For example, for Spring Cloud Gateway Server WebMVC:
spring.cloud.gateway.server.webmvc.trusted-proxies=10\.0\.0\..*
Spring Cloud Kubernetes
- Upgrade To Fabric8 7.3.1 from 6.13.x. This is necessary due to the use of Jackson 2.19.x in Spring Boot 3.5.0.
There is precedence in upgrading a major dependency in a minor with Spring Data and database drivers. #1923.
2025-05-29
- Spring Cloud Starter Build
2025.0.0
(issues) - Spring Cloud Vault
4.3.0
(issues) - Spring Cloud Bus
4.3.0
(issues) - Spring Cloud Task
3.3.0
(issues) - Spring Cloud Zookeeper
4.3.0
(issues) - Spring Cloud Kubernetes
3.3.0
(issues) - Spring Cloud Function
4.3.0
(issues) - Spring Cloud Commons
4.3.0
(issues) - Spring Cloud Circuitbreaker
3.3.0
(issues) - Spring Cloud Openfeign
4.3.0
(issues) - Spring Cloud Stream
4.3.0
(issues) - Spring Cloud Consul
4.3.0
(issues) - Spring Cloud Gateway
4.3.0
(issues) - Spring Cloud Contract
4.3.0
(issues) - Spring Cloud Config
4.3.0
(issues) - Spring Cloud Build
4.3.0
(issues) - Spring Cloud Netflix
4.3.0
(issues)
Full Changelog: v2024.0.0...v2025.0.0