Spring Boot集成Testcontainers首个测试启动过慢问题咨询

环境与配置 #

使用Java 17、Spring Boot 3.1.4版本，基于org.springframework.boot:spring-boot-testcontainers依赖构建Spring Boot应用，在IntelliJ IDEA 2022.1中运行集成测试。

build.gradle配置 #

// other settings
dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-actuator'
    implementation 'org.springframework.boot:spring-boot-starter-cache'
    implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
    implementation 'org.springframework.boot:spring-boot-starter-validation'
    implementation 'org.springframework.boot:spring-boot-starter-web'
    implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.2.0'
    implementation 'org.springdoc:springdoc-openapi-starter-webmvc-api:2.2.0'
    implementation 'org.springdoc:springdoc-openapi-starter-common:2.2.0'
    implementation 'org.flywaydb:flyway-core'
    implementation 'org.ehcache:ehcache:3.10.8'
    implementation 'org.hibernate.orm:hibernate-jcache:6.3.1.Final'
    implementation 'org.springframework.boot:spring-boot-devtools'
    compileOnly 'org.projectlombok:lombok'
    runtimeOnly 'org.postgresql:postgresql'
    annotationProcessor 'org.projectlombok:lombok'
    testImplementation 'org.springframework.boot:spring-boot-starter-test'
    testImplementation 'org.springframework.boot:spring-boot-testcontainers'
    testImplementation 'org.testcontainers:postgresql'
    testImplementation 'org.testcontainers:junit-jupiter'
    testImplementation 'io.rest-assured:rest-assured:5.3.1'
}
tasks.named('test') {
    useJUnitPlatform()
}

测试代码实现 #

TestContainersConfiguration类 #

@TestConfiguration(proxyBeanMethods = false)
public class TestContainersConfiguration {

  @Bean
  @ServiceConnection
  public PostgreSQLContainer<?> postgreSQLContainer() {
    return new PostgreSQLContainer<>("postgres:15.2-alpine")
        .withReuse(true);
  }
}

ApiIT集成测试类 #

@SpringBootTest(webEnvironment = RANDOM_PORT)
@Testcontainers
@Import(TestContainersConfiguration.class)
public class ApiIT {

  @Autowired
  protected PostgreSQLContainer postgreSQLContainer;

  @LocalServerPort
  private Integer port;

  @BeforeEach
  void setUp() {
    RestAssured.baseURI = "http://localhost:" + port;
  }

  @Test
  void test() {
    assertThat(postgreSQLContainer.isRunning()).isTrue();
  }

  @Test
  void checkHealth() {
    when().get("/api/actuator/health")
        .then().statusCode(200)
        .and().body("status", containsString("UP"));
  }
}

问题现象 #

测试可正常执行，但首个测试方法启动耗时过长：应用仅用14.461秒启动完成，且能正常访问localhost:54477/api/actuator/health，但从应用启动完成（12:17:36.138）到首个测试方法test()开始执行（12:19:44.231），延迟超过2分钟。

原因分析 #

1. Testcontainers复用配置缺失：代码中设置了.withReuse(true)，但未启用Testcontainers的复用开关，导致框架在尝试复用容器时陷入无意义的等待，或清理旧容器时耗时过长。
2. 应用后台初始化未完成：虽然应用日志显示启动完成，但Flyway迁移、缓存预热、JPA异步初始化等后台任务可能仍在执行，Spring Boot上下文刷新完成不代表所有业务bean都已就绪。
3. IntelliJ IDEA测试运行器延迟：旧版本IDEA的测试运行器存在日志缓冲或事件调度问题，导致测试方法触发时间被推迟。

解决方案 #

1. 正确配置Testcontainers复用 #

在src/test/resources/testcontainers.properties中添加：

testcontainers.reuse.enable=true

或运行测试时添加JVM参数：-Dtestcontainers.reuse.enable=true。同时手动清理残留的Testcontainers容器：

docker rm -f $(docker ps -aq --filter "label=org.testcontainers=true")

2. 确保应用完全就绪 #

修改测试类，在setUp中主动等待Actuator健康状态为UP，避免测试提前执行：

@BeforeEach
void setUp() {
    RestAssured.baseURI = "http://localhost:" + port;
    // 等待应用健康检查完全就绪
    given()
      .when().get("/api/actuator/health")
      .then().statusCode(200)
      .and().body("status", equalTo("UP"));
}

同时禁用测试环境下的DevTools自动重启：
在src/test/resources/application.properties添加：

spring.devtools.restart.enabled=false

3. 优化IntelliJ IDEA测试配置 #

• 打开测试运行配置，取消勾选Redirect test output to console，避免日志缓冲延迟。
• 将IDEA更新至2023.x及以上版本，修复旧版本测试运行器的性能问题。
• 在Build, Execution, Deployment > Build Tools > Gradle中，将Build and run using设置为IntelliJ IDEA，减少Gradle与IDE的通信延迟。

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