TestContainers JPA 存储库映射端口错误：一个详尽的故障排除指南

2024-03-08 07:41:43

解决 TestContainers 中 JPA 存储库映射端口错误的详尽指南

引言

在开发过程中，自动化测试是确保代码库健壮性和可靠性的关键。TestContainers 是一款流行的库，它允许你在真实环境中测试你的应用程序，包括数据库连接和网络交互。然而，在对使用 JPA 存储库的 Spring Boot 应用程序进行测试时，你可能会遇到一个恼人的错误：“Mapped port can only be obtained after the container is started”。本文将深入探讨这个问题，并指导你一步步解决它。

错误原因

此错误表示 TestContainers 容器尚未在测试开始时启动。TestContainers 旨在自动启动容器，但在某些情况下，它可能需要明确初始化。

解决方法

步骤 1：检查容器状态

使用 postgreSQLContainer.isRunning() 方法验证容器是否已启动。如果返回 false，则你需要明确初始化容器。

步骤 2：配置 TestContainers 依赖项

确保在 build.gradle 文件中正确配置了 TestContainers 依赖项：

testCompile "org.testcontainers:testcontainers:1.14.1"
testCompile "org.testcontainers:postgresql:1.14.1"

步骤 3：初始化容器

使用 @ClassRule 注解声明 postgreSQLContainer，并创建一个 Initializer 类来将容器连接到 Spring Boot 应用程序：

@ClassRule
public static PostgreSQLContainer postgreSQLContainer = new PostgreSQLContainer("postgres:latest");

static class Initializer implements ApplicationContextInitializer<ConfigurableApplicationContext> {
  @Override
  public void initialize(ConfigurableApplicationContext configurableApplicationContext) {
    TestPropertyValues
      .of("spring.datasource.url=" + postgreSQLContainer.getJdbcUrl(),
          "spring.datasource.username=" + postgreSQLContainer.getUsername(),
          "spring.datasource.password=" + postgreSQLContainer.getPassword())
      .applyTo(configurableApplicationContext.getEnvironment());
  }
}