使用Testcontainers运行Spring集成测试时遇DOCKER_HOST未监听错误

1. 缺失Testcontainers核心激活注解：你的测试类使用了@Container声明容器，但未添加@Testcontainers注解，导致Testcontainers的Spring扩展未被触发，容器初始化逻辑完全没执行，进而触发Docker连接检测的异常警告。
2. Docker套接字路径不匹配：部分环境（比如用Snap包安装的Docker、部分Linux发行版）中，Docker守护进程的套接字路径并非默认的/var/run/docker.sock，而是/run/docker.sock或其他路径，Testcontainers默认检测路径不对就会报这个警告。
3. 版本兼容性问题：旧版Testcontainers对较新的Docker守护进程版本存在兼容性bug，导致连接检测逻辑失效。
4. IDE/终端权限未更新：虽然你已经把用户加入docker组并重启了系统，但如果IDE或终端是在组变更前启动的，进程不会自动继承新的权限，还是无法正常访问套接字。

• 补充核心注解：在测试类上添加@Testcontainers注解，激活Testcontainers的容器管理扩展，这是最可能解决你问题的关键步骤：

@SpringBootTest
@AutoConfigureMockMvc
@Testcontainers // 新增此注解
class ProductServiceApplicationTests {

    @Container
    static MongoDBContainer mongoDBContainer = new MongoDBContainer("mongo:4.4.2");

    @DynamicPropertySource
    static void setProperties(DynamicPropertyRegistry registry) {
        registry.add("spring.data.mongodb.uri", mongoDBContainer::getReplicaSetUrl);
    }

    // ...
}

• 显式指定Docker套接字路径：

  • 临时方案：在运行测试前执行环境变量设置：

    export DOCKER_HOST=unix:///run/docker.sock
    

  • 代码方案：在测试类的静态代码块中指定：

    static {
        System.setProperty("docker.host", "unix:///run/docker.sock");
    }
    

• 升级Testcontainers版本：检查你的依赖配置，将Testcontainers相关依赖升级到最新稳定版，比如Maven配置：

<dependency>
    <groupId>org.testcontainers</groupId>
    <artifactId>junit-jupiter</artifactId>
    <version>1.19.3</version>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>org.testcontainers</groupId>
    <artifactId>mongodb</artifactId>
    <version>1.19.3</version>
    <scope>test</scope>
</dependency>

• 重启IDE/终端：关闭当前运行的IDE或终端，重新打开后再运行测试，确保进程继承了最新的用户组权限。

• 验证Docker连接权限：手动执行docker ps命令，如果能正常输出容器列表，说明权限没问题；如果报错，重新执行groups命令确认当前用户确实在docker组中，必要时重新执行sudo usermod -aG docker $USER并重启系统。

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