SpringBootTest中TestContainers创建的MongoDB容器无法连接如何解决？

核心根因（90%以上的该类问题都是这个原因） #

Kotlin companion object 中的成员默认不是JVM静态成员，而TestContainers的@Container、Spring的@DynamicPropertySource注解只能识别静态成员，未加@JvmStatic注解的情况下，容器不会被自动启动，动态属性也不会被注册，Spring会默认使用本地MongoDB的连接配置。

修正后的companion object配置如下：

companion object {
    @JvmStatic
    @Container
    val mongoDbContainer: MongoDBContainer = MongoDBContainer("mongo:5.0.3")

    @JvmStatic
    @DynamicPropertySource
    fun setUpProp(registry: DynamicPropertyRegistry) {
        registry.add("spring.data.mongodb.uri", mongoDbContainer::getReplicaSetUrl)
    }
}

其他排查点 #

如果添加@JvmStatic后仍未生效，可按以下顺序排查：

• 检查测试依赖是否完整，Spring Boot 3+推荐使用官方Testcontainers Starter，Gradle Kotlin DSL依赖参考如下：

testImplementation("org.springframework.boot:spring-boot-starter-test")
testImplementation("org.springframework.boot:spring-boot-testcontainers")
testImplementation("org.testcontainers:junit-jupiter")
testImplementation("org.testcontainers:mongodb")

• 检查test/resources路径下的application配置文件，不要写死spring.data.mongodb.uri、spring.data.mongodb.host、spring.data.mongodb.port相关配置，固定配置的优先级高于DynamicPropertySource，会覆盖注册的容器地址。
• 确认测试类没有通过@TestPropertySource注解强制指定MongoDB连接参数，也没有在@SpringBootTest注解中排除MongoDB相关自动配置类。
• 可在动态属性注册方法中添加打印逻辑，验证方法是否被触发、容器连接地址是否正常：

@JvmStatic
@DynamicPropertySource
fun setUpProp(registry: DynamicPropertyRegistry) {
    val mongoUrl = mongoDbContainer.getReplicaSetUrl()
    println("Test MongoDB connection address: $mongoUrl")
    registry.add("spring.data.mongodb.uri") { mongoUrl }
}

如果执行测试时控制台没有输出上述地址，说明注解仍未被正确识别，可检查TestContainers版本是否和Spring Boot版本兼容。

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