Testcontainers配合@SpringBootTest可启动真实数据库容器运行全链路集成测试。它每次拉起干净的MySQL/PostgreSQL实例，测完自动销毁，确保SQL兼容性且避免数据污染；需Docker环境、正确依赖版本，并通过静态容器声明、@BeforeAll启动及@DynamicPropertySource等实现高效复用与隔离。
直接用 Testcontainers 启动真实数据库容器，配合 @SpringBootTest 运行全链路集成测试，是目前 Java 项目中最接近生产环境的验证方式。它不是模拟、不靠 H2、不改 SQL，而是每次测试都拉起一个干净的 MySQL 或 PostgreSQL 实例，测完自动销毁——既保证了 SQL 兼容性，又彻底避免数据污染。
一、基础依赖和环境准备
确保本地已安装 Docker Desktop（Testcontainers 依赖 Docker 守护进程）。Maven 中添加：
-
spring-boot-starter-test（含 Spring Test、JUnit 5、Mockito） -
testcontainers（核心库） -
postgresql或mysql-connector-java（对应驱动） - 可选：
jdbc-container（简化数据库容器配置）
注意：Spring Boot 3.x 推荐使用 Testcontainers 1.19+，低版本对 JDK 17+ 支持不稳定；若用 MySQL，建议选 8.0.33+ 镜像，避免时区和认证插件问题。
二、声明式启动数据库容器
最简洁的方式是在测试类中用静态字段定义容器：
立即学习“Java免费学习笔记（深入）”；
static final PostgreSQLContainer<?> postgres = new PostgreSQLContainer<>("postgres:15-alpine")
.withDatabaseName("testdb")
.withUsername("testuser")
.withPassword("testpass");
加上 @BeforeAll 启动：
static void startContainer() {
postgres.start();
System.setProperty("spring.datasource.url", postgres.getJdbcUrl());
System.setProperty("spring.datasource.username", postgres.getUsername());
System.setProperty("spring.datasource.password", postgres.getPassword());
}
这样 Spring Boot 就会自动用这个容器连接，无需修改 application-test.yml，也避免了硬编码端口冲突。
三、配合 @SpringBootTest 写真实链路测试
测试类加注解即可：
@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.NONE)
@Import(TestcontainersConfiguration.class) // 可封装 DataSource 配置
class UserRepositoryIntegrationTest { ... }
关键点：
- 不要用
@DataJpaTest，它默认配 H2；必须用@SpringBootTest才加载完整 JPA + 数据源 - 推荐关闭 Web 环境（
WebEnvironment.NONE），专注数据层；如需测 Controller，再切回MOCK或RANDOM_PORT - 每个测试方法执行前，用
@Transactional+@Rollback自动回滚事务（仅限单个测试方法内生效）
示例断言：
@Test
void shouldSaveAndFindUser() {
User saved = userRepository.save(new User("Alice", 30));
Optional<User> found = userRepository.findById(saved.getId());
assertThat(found).isPresent().hasValueSatisfying(u -> assertThat(u.getName()).isEqualTo("Alice"));
}
四、进阶：复用容器与并行优化
默认每次测试类都会启停容器，慢。可改为全局单例复用：
- 用
GenericContainer+SingletonContainer模式管理生命周期 - 在
src/test/resources/application-test.yml中统一配置spring.datasource.url指向固定容器别名（如jdbc:postgresql://test-db:5432/testdb） - 配合 Docker Compose 启动多容器（如 PostgreSQL + Redis），用
composeContainer加载docker-compose.test.yml
注意：并行执行多个测试类时，务必确保数据库名、schema 或表前缀隔离，否则可能互相干扰；可用 DynamicPropertySource 为每个测试动态生成 schema 名。
