本文旨在解决spring boot 3.0.0及更高版本中嵌入式mongodb集成测试遇到的兼容性问题。我们将详细阐述从spring boot 2.x迁移时，`de.flapdoodle.embed.mongo` 依赖和相关配置属性的变化。通过更新依赖项和调整配置，确保开发人员能够顺利地在spring boot 3.x项目中利用嵌入式mongodb进行快速、独立的集成测试。
在Spring Boot应用程序的开发过程中，使用嵌入式MongoDB进行集成测试是一种高效且独立的方式，它避免了对外部MongoDB实例的依赖。然而，从Spring Boot 2.x版本升级到3.x时，开发者可能会遇到嵌入式MongoDB无法正常启动的问题，例如常见的“Connection refused”或“Timed out while waiting to connect”错误。这主要是由于底层的de.flapdoodle.embed.mongo库与Spring Boot 3.x的集成方式发生了变化。
理解Spring Boot 3.x与嵌入式MongoDB的兼容性
Spring Boot 3.x基于Jakarta EE，并对许多核心依赖进行了升级。flapdoodle-oss项目为了支持Spring Boot 3.x，也推出了新的集成模块。旧版本的de.flapdoodle.embed.mongo依赖主要是为Spring Boot 2.7.x及更早版本设计的，因此在Spring Boot 3.x环境中直接使用会导致兼容性问题，无法正确地启动和管理嵌入式MongoDB实例。
核心解决方案：更新依赖与配置
要解决Spring Boot 3.x中嵌入式MongoDB的兼容性问题，主要需要进行两项关键更改：更新Maven依赖项和调整application.properties中的配置属性。
1. 更新嵌入式MongoDB依赖项
旧的de.flapdoodle.embed.mongo依赖不再适用于Spring Boot 3.x。你需要将其替换为专门为Spring Boot 3.x设计的集成模块。
旧的 pom.xml 依赖 (Spring Boot 2.x 兼容):
de.flapdoodle.embed de.flapdoodle.embed.mongo 3.5.3 test
新的 pom.xml 依赖 (Spring Boot 3.x 兼容):
de.flapdoodle.embed de.flapdoodle.embed.mongo.spring30x 4.5.2 test
请注意，artifactId已从de.flapdoodle.embed.mongo更改为de.flapdoodle.embed.mongo.spring30x。同时，建议访问Maven Central (https://www.php.cn/link/be7f9ca66f2fb4e760fb991d89d74002) 以获取de.flapdoodle.embed.mongo.spring30x的最新稳定版本，确保使用最新的修复和功能。
2. 调整MongoDB版本配置属性
在Spring Boot 3.x中，嵌入式MongoDB的版本配置属性的命名空间也发生了变化。它不再由Spring Boot自身管理，而是直接由flapdoodle-oss的命名空间解析。
旧的 application.properties 配置 (Spring Boot 2.x 兼容):
spring.data.mongodb.database=test spring.data.mongodb.port=27017 spring.mongodb.embedded.version=4.0.2
新的 application.properties 配置 (Spring Boot 3.x 兼容):
spring.data.mongodb.database=test spring.data.mongodb.port=27017 de.flapdoodle.mongodb.embedded.version=4.0.2
关键更改是将spring.mongodb.embedded.version替换为de.flapdoodle.mongodb.embedded.version。其他与MongoDB连接相关的属性（如spring.data.mongodb.database和spring.data.mongodb.port）通常保持不变。
示例：使用@DataMongoTest进行集成测试
完成上述依赖和配置的更新后，你可以像往常一样使用Spring Boot的测试注解来编写集成测试。@DataMongoTest注解会配置一个嵌入式MongoDB实例，并提供MongoTemplate bean，方便进行数据操作。
import com.mongodb.BasicDBObjectBuilder;
import com.mongodb.DBObject;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.data.mongo.DataMongoTest;
import org.springframework.data.mongodb.core.MongoTemplate;
import org.springframework.test.context.junit.jupiter.SpringExtension;
import static org.assertj.core.api.Assertions.assertThat;
@DataMongoTest
@ExtendWith(SpringExtension.class)
public class MongoDbSpringIntegrationTest {
@DisplayName("给定一个对象，当使用MongoDB模板保存时，对象被成功保存")
@Test
public void testSaveObjectWithMongoTemplate(@Autowired MongoTemplate mongoTemplate) {
// 准备数据
DBObject objectToSave = BasicDBObjectBuilder.start()
.add("key", "value")
.get();
// 执行保存操作
mongoTemplate.save(objectToSave, "collection");
// 验证结果
assertThat(mongoTemplate.findAll(DBObject.class, "collection"))
.extracting("key")
.containsOnly("value");
}
}在这个示例中，@DataMongoTest负责启动一个嵌入式MongoDB实例，并配置必要的Spring上下文。@ExtendWith(SpringExtension.class)确保JUnit 5与Spring Test框架集成。通过@Autowired注入的MongoTemplate可以直接用于与嵌入式数据库进行交互。
注意事项与总结
- 版本兼容性：始终关注Spring Boot版本与flapdoodle-oss嵌入式MongoDB集成库的兼容性。de.flapdoodle.embed.mongo.spring30x是为Spring Boot 3.x系列设计的，如果未来Spring Boot有重大版本更新（如4.x），可能需要寻找新的集成模块。
- 最新版本：定期检查Maven Central以获取de.flapdoodle.embed.mongo.spring30x的最新版本。新版本通常包含错误修复和性能改进。
- 测试隔离：嵌入式MongoDB为测试提供了出色的隔离性，每个测试运行都可以拥有一个干净的数据库实例，避免了测试之间的相互影响。
- 调试：如果仍然遇到问题，请检查项目的依赖树（mvn dependency:tree）以确保没有冲突的flapdoodle-oss或MongoDB驱动版本。同时，查看测试运行时的日志输出，可能会提供更具体的错误信息。
通过上述依赖项和配置属性的调整，你将能够在Spring Boot 3.x项目中成功地使用嵌入式MongoDB进行高效且可靠的集成测试，从而提升开发效率和代码质量。
