Win10+WSL2环境下TestContainers无法识别Docker环境求助

核心问题定位 #

TestContainers仍在尝试使用Npipe（Windows Docker Desktop默认通信方式）连接，而非你配置的TCP端口，大概率是配置未正确生效或优先级问题。

具体修复步骤 #

1. 修正.testcontainers.properties配置 #

将docker.host的转义格式改为properties文件的正确写法，无需转义斜杠和冒号，同时直接指定TCP连接策略，避免自动尝试Npipe：

docker.client.strategy=org.testcontainers.dockerclient.TcpSocketClientProviderStrategy
client.ping.timeout=65
docker.host=tcp://localhost:2375

2. 在IDEA运行配置中强制设置环境变量 #

IDEA环境变量优先级高于配置文件，直接添加变量确保生效：

• 打开测试类的运行配置 → 切换到「环境变量」标签
• 添加变量：DOCKER_HOST=tcp://localhost:2375

3. 验证环境变量生效 #

• Windows终端执行：echo %DOCKER_HOST%，应输出tcp://localhost:2375
• WSL终端执行：echo $DOCKER_HOST，同样应输出上述内容

4. 适配IDEA运行环境 #

• 若IDEA安装在WSL2内部（而非Windows），需将docker.host改为Unix Socket路径：

  docker.host=unix:///var/run/docker.sock
  

  你已执行sudo chmod 666 /var/run/docker.sock，权限问题可跳过。

5. 重启服务与IDE #

在WSL中重启Docker服务：

sudo systemctl restart docker

再重启IDEA，确保所有配置完全加载。

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