使用testcontainers启动PostgreSQL容器执行JUnit测试报错如何解决

你遇到的容器退出码2、初始化异常有两个核心触发原因：

1. 镜像环境变量不匹配：centos/postgresql-96-centos7是CentOS源维护的PostgreSQL镜像，和Testcontainers默认适配的官方postgres镜像的初始化参数规则不一样：
   • 官方postgres镜像识别POSTGRES_USER、POSTGRES_PASSWORD、POSTGRES_DB参数
   • CentOS源镜像只识别POSTGRESQL_USER、POSTGRESQL_PASSWORD、POSTGRESQL_DATABASE参数
     Testcontainers的withDatabaseName、withUsername、withPassword方法默认会注入官方格式的参数，CentOS镜像识别不到必需的初始化参数，就会启动失败退出。
2. 泛型强转异常：Testcontainers v1.16.2的PostgreSQLContainer是泛型类，你代码中的强制类型转换会在静态块初始化阶段就抛出类型转换异常，符合你所说的start()调用前就抛出错误的特征。

如果需要进一步确认报错细节，可以执行以下操作：

• 执行docker ps -a找到启动失败的PostgreSQL容器ID，执行docker logs <容器ID>查看容器内部的启动日志，确认是否为缺少初始化参数的报错
• 给测试启动参数加-Dtestcontainers.debug=true开启Testcontainers debug日志，查看框架传递的环境变量、调用参数是否符合预期

直接替换你的抽象类代码即可：

public abstract class AbstractRdbmsTest {
    private static final String DOCKER_IMAGE_NAME = "centos/postgresql-96-centos7";
    private static final String POSTGRESQL_USER = "user";
    private static final String POSTGRESQL_PASSWORD = "pass";
    private static final String POSTGRESQL_DATABASE = "db";

    // 用泛型通配符声明，避免强制转换
    protected static final PostgreSQLContainer<?> POSTGRESQL_CONTAINER;

    static {
        DockerImageName imgName = DockerImageName.parse(DOCKER_IMAGE_NAME).asCompatibleSubstituteFor("postgres");

        POSTGRESQL_CONTAINER = new PostgreSQLContainer<>(imgName)
                // 手动注入CentOS镜像要求的环境变量
                .withEnv("POSTGRESQL_USER", POSTGRESQL_USER)
                .withEnv("POSTGRESQL_PASSWORD", POSTGRESQL_PASSWORD)
                .withEnv("POSTGRESQL_DATABASE", POSTGRESQL_DATABASE)
                .withExposedPorts(PostgreSQLContainer.POSTGRESQL_PORT);
        // 如果需要兼容Testcontainers内置的getUsername()、getPassword()、getDatabaseName()方法，可以保留以下调用
        // .withUsername(POSTGRESQL_USER)
        // .withPassword(POSTGRESQL_PASSWORD)
        // .withDatabaseName(POSTGRESQL_DATABASE);

        POSTGRESQL_CONTAINER.start();
    }
}

• 建议不要用静态块初始化容器，改用JUnit4的@ClassRule注解管理容器生命周期，避免静态初始化异常排查困难
• 如果调用POSTGRESQL_CONTAINER.getJdbcUrl()连接失败，可以手动构造JDBC地址：

  String jdbcUrl = String.format("jdbc:postgresql://%s:%s/%s",
          POSTGRESQL_CONTAINER.getHost(),
          POSTGRESQL_CONTAINER.getMappedPort(PostgreSQLContainer.POSTGRESQL_PORT),
          POSTGRESQL_DATABASE);
  

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