Mac环境下Scalatest集成测试报错：无法找到有效Docker环境

针对Mac上Scalatest集成测试依赖Postgres容器时出现的该错误，即使Docker Desktop已启动且能正常访问容器，可尝试以下排查和解决步骤：

• 检查环境变量配置

  • 终端执行echo $DOCKER_HOST，确认输出为unix:///var/run/docker.sock。若为空，手动导出：export DOCKER_HOST=unix:///var/run/docker.sock，再重新运行测试。
  • 若之前配置过远程Docker连接，执行unset DOCKER_CERT_PATH和unset DOCKER_TLS_VERIFY清空相关变量，避免干扰本地Docker环境。

• 验证Docker socket权限

  • 执行ls -l /var/run/docker.sock查看文件所属组（通常为docker），若当前用户不在该组，执行sudo usermod -aG docker $USER，重启终端或重新登录后再测试。
  • 临时用sudo运行测试，若能正常执行，即可确认是权限问题导致。

• 检查Testcontainers配置（若使用）

  • 若测试基于Testcontainers，可在测试代码中添加调试代码确认Docker主机：

    import org.testcontainers.DockerClientFactory
    println(DockerClientFactory.instance().dockerHost)
    

  • 也可在~/.testcontainers.properties中添加配置docker.host=unix:///var/run/docker.sock，强制指定Docker主机地址。

• 重启相关服务

  • 完全重启Docker Desktop，关闭并重新打开运行测试的IDE（如IntelliJ），确保环境变量和socket连接刷新。

• 检查Docker Desktop设置

  • 进入Docker Desktop偏好设置的「Resources」→「File Sharing」，确认/var/run已在共享列表中，若未添加则补上。
  • 确认「General」中「Use the Docker socket from the macOS host」选项已勾选。

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