Testcontainers核心是自动启停真实Docker依赖容器并自动清理。需添加testcontainers及对应组件（如postgresql）依赖，用@Container注解静态容器字段实现生命周期自动管理，并通过getJdbcUrl等方法获取连接信息，结合@DynamicPropertySource注入Spring配置。
在 Java 单元测试中使用 Testcontainers，核心是让测试自动启动真实依赖（如 PostgreSQL、Redis、Kafka 等）的 Docker 容器，并在测试结束后自动清理。它不是模拟（mock），而是端到端的集成验证，同时保持测试的可重复性和隔离性。
1. 添加依赖
以 Maven 为例，在 pom.xml 中引入 Testcontainers 及对应模块：
- 基础库：
testcontainers - 常用组件（如 PostgreSQL）：
postgresql-container或直接用junit-jupiter+ 对应模块
示例依赖片段：
<dependency> <groupId>org.testcontainers</groupId> <artifactId>testcontainers</artifactId> <scope>test</scope> </dependency> <dependency> <groupId>org.testcontainers</groupId> <artifactId>postgresql</artifactId> <scope>test</scope> </dependency>
2. 声明并启动容器（推荐使用 @Container 注解）
JUnit 5 下最简洁的方式是用 @Container 静态字段声明容器实例，Testcontainers 会自动管理生命周期（启动/停止）：
立即学习“Java免费学习笔记（深入）”；
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
public class UserRepositoryTest {
static PostgreSQLContainer<?> postgres = new PostgreSQLContainer<>("postgres:15")
.withDatabaseName("testdb")
.withUsername("testuser")
.withPassword("testpass");
@BeforeAll
static void startContainer() {
postgres.start();
}
@AfterAll
static void stopContainer() {
postgres.stop();
}
@Test
void shouldFindUserById() {
String jdbcUrl = postgres.getJdbcUrl();
// 构建 DataSource 或 EntityManagerFactory 使用该 URL
// 执行测试逻辑...
}
}
更现代写法（JUnit 5.15+ 支持）可直接用 @Container 注解静态字段，无需手动 start()/stop()：
static final PostgreSQLContainer<?> postgres =
new PostgreSQLContainer<>("postgres:15")
.withDatabaseName("testdb");
然后加上 @Container 注解（注意：必须是 static 字段）：
@Container static PostgreSQLContainer<?> postgres = ...;
3. 获取连接信息并注入测试环境
容器启动后，通过方法获取运行时参数：
-
postgres.getJdbcUrl()→ 完整 JDBC 连接字符串 -
postgres.getUsername()/postgres.getPassword() -
postgres.getHost()+postgres.getMappedPort(5432)→ 手动拼接地址（适合非 JDBC 场景）
若用 Spring Boot，可结合 @DynamicPropertySource 自动覆盖 application.properties 中的数据源配置：
@DynamicPropertySource
static void configureProperties(DynamicPropertyRegistry registry) {
registry.add("spring.datasource.url", postgres::getJdbcUrl);
registry.add("spring.datasource.username", postgres::getUsername);
registry.add("spring.datasource.password", postgres::getPassword);
}
这样 @SpringBootTest 测试就能自动使用容器数据库，无需额外配置。
4. 注意事项与最佳实践
- Docker 守护进程必须在本地运行（Mac/Windows 启动 Desktop，Linux 确保
dockerd已启动） - 避免在单个测试类中启动多个重量级容器；可复用容器（如共用一个 PostgreSQL 实例，不同 schema 隔离）提升速度
- 敏感操作（如清库）建议在
@BeforeEach中执行，而非依赖容器重启（更快更稳定） - 网络模式默认为
bridge，容器间通信需用withNetwork(...)显式配置 - 首次拉取镜像较慢，可提前
docker pull postgres:15缓存
