SpringBoot 3.2.0集成Testcontainers与MongoDB报流提前结束异常

这个问题属于Spring Boot 3.2.0与Testcontainers集成的已知缺陷，并非你的配置错误，该问题已在Spring Boot 3.2.1版本中修复。

问题原因 #

测试执行完成后，Testcontainers会自动关闭MongoDB容器，但Spring Boot的Mongo客户端后台监控线程（DefaultServerMonitor）此时仍在尝试与已关闭的容器建立连接或读取数据，因此抛出MongoSocketReadException（流提前结束）。

解决方案 #

你可以选择以下任一方式解决：

1. 升级Spring Boot版本到3.2.1+

直接修改Gradle配置中的Spring Boot版本：

plugins {
    id 'java'
    id 'org.springframework.boot' version '3.2.1' // 升级至修复后的版本
    id 'io.spring.dependency-management' version '1.1.4'
}

升级后，Spring Boot会正确处理容器关闭时的Mongo客户端生命周期，避免异常抛出。

2. 手动管理MongoClient生命周期（适用于无法升级的场景）

在测试类中添加@PreDestroy方法，确保容器关闭前先关闭Mongo客户端：

@Testcontainers
@SpringBootTest
class DemoApplicationTests {

    @Container
    @ServiceConnection
    static MongoDBContainer mongoDBContainer = new MongoDBContainer("mongo:latest");

    @Autowired
    private MongoClient mongoClient;

    @Test
    void contextLoads() {
    }

    @PreDestroy
    void closeMongoClient() {
        mongoClient.close();
    }
}

3. 调整容器停止策略（临时 workaround）

通过Testcontainers配置延迟容器关闭，给客户端足够时间停止监控：

static {
    mongoDBContainer.withShutdownTimeout(Duration.ofSeconds(5));
}

验证 #

无论使用哪种方案，重新运行测试后，该异常都不会再出现。

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