TestContainers GenericContainer在Podman Host网络模式下启动失败求助

问题背景 #

在无根（rootless）Podman 5.4.0环境中使用TestContainers 1.21.3执行集成测试时，启动GenericContainer会触发断言失败。原因是：

• 无根Podman默认自动使用Host网络模式；
• Host网络模式下执行podman inspect，返回的NetworkSettings中Ports为空对象{}，Networks的host字段所有值均为null；
• TestContainers的GenericContainer第457行断言依赖podman inspect返回的端口信息，因此直接触发失败。

podman inspect输出示例：

[
 {
  "Id" : "xxxx",
  // ... 其他字段省略
  "NetworkSettings": {
    // ... 其他字段省略
    "Ports": {},
    "Networks": {
      "host": {
        // 所有字段值均为null
      }
    }
  }
]

这是Bug吗？ #

不算TestContainers的Bug，本质是无根Podman的Host网络模式特性导致的：Host网络下容器直接复用主机网络栈，Podman不会创建端口映射，自然不会在inspect结果中返回端口相关信息；而TestContainers的默认断言逻辑是基于端口映射场景设计的，两者不匹配才触发了失败。

解决方法 #

1. 跳过端口绑定检查 #

直接禁用TestContainers的端口一致性断言，适合不需要依赖端口映射的场景：

GenericContainer container = new GenericContainer("你的镜像名")
    .withExposedPorts(8080) // 按需指定容器暴露端口
    .disablePortBindCheck(); // 关键：跳过端口绑定检查逻辑

2. 强制使用非Host网络模式 #

手动指定Podman使用桥接网络（比如默认的podman网络），让TestContainers能正常获取端口映射信息：

GenericContainer container = new GenericContainer("你的镜像名")
    .withExposedPorts(8080)
    .withNetworkMode("podman"); // 指定使用Podman默认桥接网络

如果需要自定义网络，确保网络已提前创建，或者让TestContainers自动管理网络资源。

3. 升级TestContainers版本 #

TestContainers 1.22及以上版本对Podman的兼容性更好，已针对无根Podman的Host网络场景做了适配，升级后可避免该断言问题。

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