Spring Boot 3.4.1中DynamicPropertyRegistry替代方案失效问题

我有一个基于Spring Boot v3.2.5 + Testcontainers的应用，原本运行正常。升级到Spring Boot v3.4.1后，原来通过在PostgreSQLContainer的Bean方法中注入DynamicPropertyRegistry来设置spring.flyway.command属性的方式报错。根据官方发布说明，我改用DynamicPropertyRegistrar实现，但修改代码后发现，MyFlywayMigrationStrategy中通过@Value注入的spring.flyway.command值并非我设置的内容，想搞清楚对DynamicPropertyRegistrar的理解误区在哪。

原代码（Spring Boot 3.2.5） #

@Bean
@RestartScope
@ServiceConnection
public PostgreSQLContainer<?> postgresContainer(DynamicPropertyRegistry properties) {
  properties.add("spring.flyway.command", () -> MyFlywayMigrationStrategy.MIGRATE);
  return new PostgreSQLContainer<>(DockerImageName.parse(PostgresInitializer.POSTGRES_IMAGE));
}

修改后的代码（Spring Boot 3.4.1） #

@Bean
@DependsOn("postgresContainerRegistrar")
@RestartScope
@ServiceConnection
public PostgreSQLContainer<?> postgresContainer() {
  return new PostgreSQLContainer<>(DockerImageName.parse(PostgresInitializer.POSTGRES_IMAGE));
}

@Bean
public DynamicPropertyRegistrar postgresContainerRegistrar() {
  return registry -> {
    registry.add("spring.flyway.command", () -> MyFlywayMigrationStrategy.MIGRATE);
  };
}

属性注入代码 #

@Autowired
public MyFlywayMigrationStrategy(
    @Value("${spring.flyway.command:validate}") String command,
    ApplicationContext applicationContext) {
  this.command = command;
  this.applicationContext = applicationContext;
}

核心理解误区 #

• 依赖方向搞反：你给postgresContainer Bean添加@DependsOn("postgresContainerRegistrar")，但真正需要依赖postgresContainerRegistrar的是MyFlywayMigrationStrategy——只有让属性使用者在属性注册完成后再实例化，才能拿到正确的值。
• 注册时机不匹配：DynamicPropertyRegistrar的作用是在Spring环境初始化早期注册属性，若MyFlywayMigrationStrategy的实例化早于属性注册，@Value就会读取到默认值validate。

正确实现方式 #

方式一：调整使用者的依赖关系

如果MyFlywayMigrationStrategy是通过@Component声明的，直接添加@DependsOn：

@Component
@DependsOn("postgresContainerRegistrar")
public class MyFlywayMigrationStrategy {
    // 原有逻辑不变
}

如果是通过@Bean声明的，在Bean方法上添加@DependsOn：

@Bean
@DependsOn("postgresContainerRegistrar")
public MyFlywayMigrationStrategy myFlywayMigrationStrategy() {
    return new MyFlywayMigrationStrategy(...);
}

方式二：使用@DynamicPropertySource（推荐）

Spring Boot 3.4+推荐用@DynamicPropertySource静态方法来注册动态属性，这种方式能确保属性在依赖Bean实例化前完成注册，无需手动处理依赖关系：

@Bean
@RestartScope
@ServiceConnection
public PostgreSQLContainer<?> postgresContainer() {
    return new PostgreSQLContainer<>(DockerImageName.parse(PostgresInitializer.POSTGRES_IMAGE));
}

@DynamicPropertySource
static void registerFlywayProperties(DynamicPropertyRegistry registry) {
    registry.add("spring.flyway.command", () -> MyFlywayMigrationStrategy.MIGRATE);
}

原代码在3.2.5生效的原因 #

Spring Boot 3.2.x允许直接将DynamicPropertyRegistry注入到容器Bean方法中，此时属性会在容器Bean创建时立即注册，依赖该属性的Bean会因初始化顺序拿到正确值。但3.4.x废弃了这种用法，要求改用DynamicPropertyRegistrar或@DynamicPropertySource，你错误调整了依赖方向，导致属性注册晚于Bean实例化，才出现问题。

内容的提问来源于stack exchange，提问作者Kevin