Spring WebFlux+Testcontainers测试中Flyway Clean禁用问题排查

以下是针对问题的具体排查和解决步骤：

1. 确认配置加载的优先级与时机 #

Spring Boot测试中配置属性有明确加载优先级，@TestPropertySource、@DynamicPropertySource的优先级高于application-test.yml，如果测试类同时使用这些注解，可能覆盖了yml中的设置。另外Flyway在Spring上下文初始化时就会读取配置，如果你的扩展类是在Flyway初始化后才设置cleanDisabled，修改不会生效。

2. 直接在扩展类中强制修改Flyway配置 #

不要依赖配置文件传递属性，而是在清理逻辑中直接获取Flyway实例，强制关闭clean禁用：

public class ClearDatabaseExtension implements BeforeTestExecutionCallback {

    @Override
    public void beforeTestExecution(ExtensionContext context) {
        // 获取Spring上下文
        ApplicationContext appContext = SpringExtension.getApplicationContext(context);
        Flyway flyway = appContext.getBean(Flyway.class);
        
        // 强制设置cleanDisabled为false
        flyway.getConfiguration().setCleanDisabled(false);
        // 执行清理
        flyway.clean();
        // 可选：重新执行迁移
        flyway.migrate();
    }
}

3. 用@DynamicPropertySource确保配置生效 #

结合Testcontainers的动态属性配置，直接在测试类中设置Flyway属性，确保优先级最高：

@SpringBootTest
@Testcontainers
@ClearDatabase
public class YourTestClass {

    @Container
    static PostgreSQLContainer<?> postgresContainer = new PostgreSQLContainer<>("postgres:15-alpine");

    @DynamicPropertySource
    static void setDatabaseProperties(DynamicPropertyRegistry registry) {
        registry.add("spring.datasource.url", postgresContainer::getJdbcUrl);
        registry.add("spring.datasource.username", postgresContainer::getUsername);
        registry.add("spring.datasource.password", postgresContainer::getPassword);
        // 直接设置Flyway clean禁用为false
        registry.add("spring.flyway.clean-disabled", () -> false);
    }
}

4. 验证扩展类的执行顺序与注解有效性 #

• 确保@ClearDatabase注解正确关联扩展类：

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@ExtendWith(ClearDatabaseExtension.class)
public @interface ClearDatabase {
}

• 如果有多个扩展类，可通过@Order指定执行顺序，确保ClearDatabaseExtension在Flyway初始化后、测试执行前运行：

public class ClearDatabaseExtension implements BeforeTestExecutionCallback, Ordered {
    @Override
    public int getOrder() {
        // 设置合适的执行顺序，确保在Flyway初始化后触发
        return 100;
    }
}

5. 排查配置是否被其他组件覆盖 #

• 在扩展类中打印Flyway配置，确认cleanDisabled的实际值：

System.out.println("Flyway cleanDisabled status: " + flyway.getConfiguration().isCleanDisabled());

• 检查是否有其他配置类、自动配置类或第三方库修改了Flyway的cleanDisabled属性。

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