如何解决TestContainers集成测试中flywayInitializer创建失败错误

报错核心是**org.testcontainers.jdbc.ContainerDatabaseDriver 不接受普通的PostgreSQL JDBC URL格式**。出现这个问题的原因是你的配置和测试代码存在冲突：

1. 主环境application.properties中错误地使用了TestContainers专属驱动，但URL格式不符合TestContainers要求（缺少tc:前缀）；
2. 测试代码中手动覆盖了数据源URL为普通PostgreSQL格式，但驱动还是TestContainers的，导致Flyway初始化时不兼容。

1. 修正主环境配置（application.properties） #

TestContainers的驱动和专属URL只应该用于测试环境，主环境恢复为普通PostgreSQL配置：

# 替换TestContainers驱动为普通PostgreSQL驱动
spring.datasource.driver-class-name=org.postgresql.Driver
# 改为正常的PostgreSQL URL格式（根据你的生产/开发环境调整地址、端口、库名）
spring.datasource.url=jdbc:postgresql://localhost:5432/proforma
spring.datasource.username=test
spring.datasource.password=pass

# 其他原有配置保留
spring.jpa.properties.hibernate.jdbc.lob.non_contextual_creation=true
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect
spring.jpa.hibernate.ddl-auto=update
logging.level.org.hibernate.SQL=DEBUG

feign.autoconfiguration.jackson.enabled=true
feign.client.config.product.connect-timeout=5000
feign.client.config.product.read-timeout=5000
feign.client.config.product.logger-level=FULL

spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true
spring.jpa.databasePlatform=org.hibernate.dialect.PostgreSQLDialect
spring.main.allow-bean-definition-overriding=true
spring.profiles.active=dev

2. 调整测试代码配置 #

方式一：移除手动数据源初始化，简化测试类 #

利用TestContainers的自动配置，无需手动初始化数据源：

@DataJpaTest
@Testcontainers
@AutoConfigureTestDatabase(replace = AutoConfigureTestDatabase.Replace.NONE)
// 指定测试用配置，隔离主环境配置
@ActiveProfiles("test")
public abstract class BaseRepositoryTest {
    @Container
    private static final PostgreSQLContainer<?> database = new PostgreSQLContainer<>("postgres:13.6");

    // 移除自定义的DataSourceInitializer，TestContainers会自动注入正确的数据源配置
}

方式二：保留手动初始化，但确保驱动和URL匹配 #

如果你需要手动控制数据源，需移除TestContainers驱动指定，因为database.getJdbcUrl()返回的是带tc:前缀的URL，会自动关联TestContainers驱动：

@DataJpaTest
@Testcontainers
@AutoConfigureTestDatabase(replace = AutoConfigureTestDatabase.Replace.NONE)
@ContextConfiguration(initializers = BaseRepositoryTest.DataSourceInitializer.class)
public abstract class BaseRepositoryTest {
    @Container
    private static final PostgreSQLContainer<?> database = new PostgreSQLContainer<>("postgres:13.6");

    public static class DataSourceInitializer implements ApplicationContextInitializer<ConfigurableApplicationContext> {
        @Override
        public void initialize(@NotNull ConfigurableApplicationContext applicationContext) {
            TestPropertySourceUtils.addInlinedPropertiesToEnvironment(
                    applicationContext,
                    "spring.test.database.replace=none",
                    "spring.datasource.url=" + database.getJdbcUrl(),
                    "spring.datasource.username=" + database.getUsername(),
                    "spring.datasource.password=" + database.getPassword(),
                    // 移除TestContainers驱动配置，让URL自动关联正确驱动
                    "spring.datasource.driver-class-name="
            );
        }
    }
}

3. 处理Flyway（可选） #

如果测试中不需要Flyway执行迁移，可以在测试类中禁用它：

@DataJpaTest
@Testcontainers
@AutoConfigureTestDatabase(replace = AutoConfigureTestDatabase.Replace.NONE)
@DisableFlyway // 禁用Flyway，避免测试时执行迁移
public abstract class BaseRepositoryTest {
    // ... 原有代码
}

• TestContainers的专属URL格式必须是jdbc:tc:<数据库类型>:<版本>:///<库名>?<参数>，比如jdbc:tc:postgresql:13.6:///test；
• 主环境和测试环境的数据源配置要隔离，避免驱动和URL不匹配的冲突；
• 使用@Container创建的容器，getJdbcUrl()返回的URL已经包含TestContainers所需的前缀，无需手动添加驱动配置。

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