Java 中怎么在单元测试中使用 Testcontainers 容器-java教程-PHP中文网

testcontainers核心是自动启停真实docker依赖容器并自动清理。需添加testcontainers及对应组件（如postgresql）依赖，用@container注解静态容器字段实现生命周期自动管理，并通过getjdbcurl等方法获取连接信息，结合@dynamicpropertysource注入spring配置。

java 中怎么在单元测试中使用 testcontainers 容器

在 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 会自动管理生命周期（启动/停止）：

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()：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

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 测试就能自动使用容器数据库，无需额外配置。