Testcontainers Java PostgreSQL搭配Podman配置不生效问题咨询

问题背景 #

org.testcontainers:postgresql:jar:1.18.3 存在配置忽略问题：从Docker Desktop切换到Podman后，按照资料在~/.testcontainers.properties中配置了以下内容，但Ryuk仍会启动并抛出异常导致测试退出，容器复用设置也不生效：

docker.host=unix:///tmp/podman.sock                                                                                                                                                           
ryuk.disabled=true
testcontainers.ryuk.disabled=true
testcontainers.checks.disable=true
testcontainers.reuse.enable=true

# 尝试过的其他键
TESTCONTAINERS_REUSE_ENABLE=true
REUSE_ENABLE=true
reuse.enable=true

问题原因 #

查看Testcontainers源码可知：

• TestContainersConfiguration.loadConfiguration会加载配置文件，但RyukResourceReaper.init仅检查环境变量TESTCONTAINERS_REUSE_ENABLE，不会读取配置文件中的禁用/复用设置
• 配置文件中的相关项无法覆盖环境变量的优先级

试过的无效方案 #

• GenericContainer.setEnv()：仅设置容器内部的环境变量，无法影响Testcontainers自身的环境变量检查逻辑
• Maven Surefire插件配置环境变量：配置后TESTCONTAINERS_REUSE_ENABLE的值会被自动添加引号变为"true"，导致Boolean.parseBoolean解析为false
• 反射修改System.getenv()：临时可行，但属于hack手段，不是正规解决方案

正确配置方式（Mac环境） #

方式1：终端设置环境变量后运行测试 #

直接在终端导出环境变量，再执行测试命令：

export TESTCONTAINERS_RYUK_DISABLED=true
export TESTCONTAINERS_REUSE_ENABLE=true
export DOCKER_HOST=unix:///tmp/podman.sock
mvn test

方式2：Maven Surefire插件正确配置 #

在pom.xml的Surefire插件中，通过environmentVariables配置时确保值不带引号，或使用systemPropertyVariables传递配置：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <configuration>
        <!-- 方式A：使用系统属性 -->
        <systemPropertyVariables>
            <testcontainers.ryuk.disabled>true</testcontainers.ryuk.disabled>
            <testcontainers.reuse.enable>true</testcontainers.reuse.enable>
            <docker.host>unix:///tmp/podman.sock</docker.host>
        </systemPropertyVariables>

        <!-- 方式B：使用环境变量，注意值不要加引号 -->
        <environmentVariables>
            <TESTCONTAINERS_RYUK_DISABLED>true</TESTCONTAINERS_RYUK_DISABLED>
            <TESTCONTAINERS_REUSE_ENABLE>true</TESTCONTAINERS_REUSE_ENABLE>
            <DOCKER_HOST>unix:///tmp/podman.sock</DOCKER_HOST>
        </environmentVariables>
    </configuration>
</plugin>

方式3：IDE运行配置添加环境变量 #

以IntelliJ IDEA为例：

1. 打开测试类的运行配置
2. 在「Environment variables」中添加：

TESTCONTAINERS_RYUK_DISABLED=true;TESTCONTAINERS_REUSE_ENABLE=true;DOCKER_HOST=unix:///tmp/podman.sock

补充说明 #

Testcontainers 1.18.x版本中，Ryuk相关的控制项优先读取环境变量，因此直接设置环境变量是最可靠的方式。另外可通过podman system info | grep "Socket Path"确认Podman socket路径是否正确，Mac下默认是/tmp/podman.sock。

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