Mac M1 Pro芯片下无法启动Testcontainers Docker的解决方案咨询

• 检查Docker Socket权限

  1. 执行ls -l /var/run/docker.sock查看权限，确认文件所属组为docker。
  2. 若当前用户不在docker组，执行sudo usermod -aG docker $USER，之后重启终端或重新登录系统。
  3. 若存在~/.docker/run/docker.sock，设置环境变量：export DOCKER_HOST=unix://$HOME/.docker/run/docker.sock，也可在Testcontainers配置中指定该路径。

• 验证Docker Daemon运行状态
  终端执行docker ps，若能正常输出容器列表，说明Daemon正常运行；若报错，确认Docker Desktop已启动，或通过右上角图标选择Quit Docker Desktop后重新打开。

• 配置Testcontainers相关环境变量
  在运行测试前设置以下环境变量：

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

  不同语言项目可对应配置：Java项目可在pom.xml/gradle中添加环境变量；Python项目可在测试脚本开头或运行前导出变量。

• 检查Docker Desktop文件共享设置
  打开Docker Desktop设置→Resources→File Sharing，添加并勾选你的项目目录，确保Testcontainers能正常挂载本地文件。

• 重置Docker Desktop到默认设置
  打开Docker Desktop设置→Troubleshoot→Reset to factory defaults，重置后重启Docker，重新启用Allow the default Docker socket to be used选项，再进行测试。

• 检查Testcontainers与镜像版本兼容性
  ryuk:0.4.0可能与Docker Desktop 4.21.1不兼容，尝试升级Testcontainers到最新稳定版，或更换兼容的ryuk镜像版本（如ryuk:0.5.1）。

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