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) 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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants