Spring Boot中用TestContainers启用多ServiceConnection数据库的正确方式

问题现象 #

在Spring Boot应用中使用PostgreSQL和MySQL多数据源，生产环境运行正常，但开发模式集成TestContainers时遇到两个问题：

• 配置类中仅PostgreSQL容器Bean启动，MySQL容器被自动丢弃；
• 添加@DependsOn("mySQLContainer")后MySQL容器可启动，但Flyway错误连接到PostgreSQL（预期Flyway连接MySQL，Liquibase连接PostgreSQL）。

核心原因 #

1. @ServiceConnection的局限性：@ServiceConnection注解默认会自动将容器绑定到Spring的主数据源配置（spring.datasource.*），当存在多个标注该注解的容器Bean时，Spring Boot无法自动区分优先级，只会保留最后初始化的容器配置，导致另一个容器被覆盖。
2. 属性绑定时机问题：手动添加@DependsOn虽然能强制启动所有容器，但Flyway/Liquibase的配置加载时机早于部分动态属性的绑定，导致它们 fallback到主数据源（PostgreSQL），而非预期的目标数据库。

正确解决方案 #

核心思路：手动管理TestContainers容器的生命周期，统一通过DynamicPropertyRegistrar绑定所有数据源、Flyway、Liquibase的配置，明确指定每个组件对应的数据库容器，避免依赖@ServiceConnection的自动绑定逻辑。

完整可行代码示例（Spring Boot 3.4.0+） #

@TestConfiguration(proxyBeanMethods = false)
public class ContainersConfiguration {

    @Bean
    MySQLContainer<?> mySQLContainer() {
        // 初始化MySQL容器，指定镜像版本
        MySQLContainer<?> mySQLContainer = new MySQLContainer<>(DockerImageName.parse("mysql").withTag("9.1"));
        // 手动启动容器
        mySQLContainer.start();
        return mySQLContainer;
    }

    @Bean
    PostgreSQLContainer<?> postgreSQLContainer() {
        // 初始化PostgreSQL容器，指定镜像版本
        PostgreSQLContainer<?> postgreSQLContainer = new PostgreSQLContainer<>(DockerImageName.parse("postgres").withTag("17.0-alpine"));
        // 手动启动容器
        postgreSQLContainer.start();
        return postgreSQLContainer;
    }

    @Bean
    public DynamicPropertyRegistrar databaseProperties(
            MySQLContainer<?> mySQLContainer, PostgreSQLContainer<?> postgreSQLContainer) {
        return (properties) -> {
            // 绑定MySQL数据源属性（对应Flyway使用的库）
            properties.add("app.datasource.cardholder.url", mySQLContainer::getJdbcUrl);
            properties.add("app.datasource.cardholder.username", mySQLContainer::getUsername);
            properties.add("app.datasource.cardholder.password", mySQLContainer::getPassword);
            
            // 绑定PostgreSQL数据源属性（对应Liquibase使用的库）
            properties.add("app.datasource.member.url", postgreSQLContainer::getJdbcUrl);
            properties.add("app.datasource.member.username", postgreSQLContainer::getUsername);
            properties.add("app.datasource.member.password", postgreSQLContainer::getPassword);
            
            // 可选：如果需要将PostgreSQL作为主数据源，绑定spring.datasource.*
            properties.add("spring.datasource.url", postgreSQLContainer::getJdbcUrl);
            properties.add("spring.datasource.username", postgreSQLContainer::getUsername);
            properties.add("spring.datasource.password", postgreSQLContainer::getPassword);
        };
    }
}

配套配置文件（application.properties） #

保持原有配置即可，动态属性会自动覆盖配置文件中的占位符：

## Flyway 绑定MySQL数据源
spring.flyway.url=${app.datasource.cardholder.url}
spring.flyway.user=${app.datasource.cardholder.username}
spring.flyway.password=${app.datasource.cardholder.password}

## Liquibase 绑定PostgreSQL数据源
spring.liquibase.url=${app.datasource.member.url}
spring.liquibase.user=${app.datasource.member.username}
spring.liquibase.password=${app.datasource.member.password}

关键优化点 #

• 移除所有@ServiceConnection注解，避免自动绑定主数据源的冲突；
• 手动调用容器的start()方法，确保所有容器都启动；
• 通过DynamicPropertyRegistrar统一管理所有动态属性，确保Flyway/Liquibase的配置直接绑定到对应容器的属性，避免 fallback；
• 容器Bean之间无需@DependsOn，因为DynamicPropertyRegistrar会自动依赖注入两个容器Bean，Spring会确保它们都初始化完成。

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