Skip to content

Conversation

@amazon7737
Copy link

@amazon7737 amazon7737 commented Jan 11, 2026

Description

As discussed in #4022, this PR removes the spring-boot-properties-migrator dependency from the following starter modules:

  • spring-cloud-starter-gateway-server-webflux
  • spring-cloud-starter-gateway-server-webmvc

These modules should not have a forced dependency on the migrator tool, as it is intended for temporary migration use and can cause unexpected property overrides in production environments (especially with list-based properties like routes).

Related Issue

Fixes #4022

Motivation and Context

The spring-boot-properties-migrator was added as a temporary measure (marked with TODO for 5.0). Removing it now aligns with the goal of keeping new starters production-ready and giving users the choice to add it manually if needed, as stated in the release notes.

How Has This Been Tested?

  • Verified that the dependency is removed using mvn dependency:tree.
  • Executed ./mvnw clean install -DskipTests to ensure the build remains stable after removal.

/cc @ryanjbaxter @spencergibb

@amazon7737 amazon7737 marked this pull request as draft January 11, 2026 08:04
@amazon7737 amazon7737 marked this pull request as ready for review January 13, 2026 10:32
@amazon7737 amazon7737 changed the title [Draft] Remove spring-boot-properties-migrator from starters (#4022) Jan 13, 2026
@amazon7737 amazon7737 force-pushed the fix/4022-remove-migrator branch from f2c1498 to 8fe2f48 Compare January 14, 2026 15:02
@DidierLoiseau
Copy link

In #4022 I had only mentioned the new modules, I’m not sure whether it makes sense for the deprecated ones.

@amazon7737
Copy link
Author

amazon7737 commented Jan 16, 2026

@DidierLoiseau I hadn't considered the deprecated modules, thanks for catching that. To prioritize backward compatibility and stability, I agree that we should keep the migrator in the legacy and widely used modules.

I will revert the changes for spring-cloud-starter-gateway and spring-cloud-starter-gateway-mvc, while keeping the removal only for the new server-specific modules (server-webflux and server-webmvc)

As discussed in spring-cloud#4022, removing the temporary properties-migrator
dependency from new server-only starter modules (server-webflux and
server-webmvc) to avoid unexpected property overrides in production
environments.

Legacy starter modules (spring-cloud-starter-gateway and
spring-cloud-starter-gateway-mvc) will retain the migrator for
backward compatibility.

Resolves spring-cloud#4022

Signed-off-by: Kangmin Kim <76634341+amazon7737@users.noreply.github.com>
@amazon7737 amazon7737 force-pushed the fix/4022-remove-migrator branch from 8fe2f48 to 014c44e Compare January 16, 2026 13:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

3 participants