ARM架构Mac上IntelliJ IDEA无法识别Docker Desktop容器求助

问题背景 #

在M系列ARM架构Mac上安装Docker Desktop后，docker-compose up可正常执行、容器状态显示正常，但出现以下问题：

• 功能测试抛出异常：

java.lang.IllegalStateException: Could not find a valid Docker environment. Please see logs and check configuration

日志核心错误：

[main] ERROR o.t.d.DockerClientProviderStrategy - Could not find a valid Docker environment. Please check configuration. Attempted configurations were:
[main] ERROR o.t.d.DockerClientProviderStrategy -     UnixSocketClientProviderStrategy: failed with exception InvalidConfigurationException (Could not find unix domain socket). Root cause NoSuchFileException (/var/run/docker.sock)
[main] ERROR o.t.d.DockerClientProviderStrategy -     DockerMachineClientProviderStrategy: failed with exception ShellCommandException (Exception when executing docker-machine status ). Root cause InvalidExitValueException (Unexpected exit value: 1, allowed exit values: [0], executed command [docker-machine, status, ], output was 122 bytes:
Docker machine "" does not exist. Use "docker-machine ls" to list machines. Use "docker-machine create" to add a new one.)
[main] ERROR o.t.d.DockerClientProviderStrategy - As no valid configuration was found, execution cannot continue

• IntelliJ IDEA配置Docker时提示：

Cannot connect: Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running? (Details: [2] No such file or directory)

• 尝试创建Docker Machine失败，因VirtualBox不支持M1/M2 Mac。

核心原因 #

Docker Desktop for ARM Mac默认不创建/var/run/docker.sock传统Unix套接字路径，而是使用容器内的专属套接字；同时Docker Machine依赖的VirtualBox完全不兼容ARM架构，无需使用。

解决方案 #

1. 修复docker.sock路径映射 #

创建软链接将Docker Desktop的实际套接字路径映射到/var/run/docker.sock：

sudo ln -s ~/Library/Containers/com.docker.docker/Data/docker.sock /var/run/docker.sock

注意：Docker Desktop重启后该软链接可能失效，可将此命令添加到开机脚本中自动执行。

2. 配置测试框架（如Testcontainers）的Docker连接 #

如果是Testcontainers引发的异常，通过以下方式指定正确的Docker主机：

• 代码内设置：

// 使用套接字方式
System.setProperty("docker.host", "unix:///Users/你的用户名/Library/Containers/com.docker.docker/Data/docker.sock");
// 或开启Docker Desktop的TCP暴露后使用TCP方式
System.setProperty("docker.host", "tcp://localhost:2375");

• 环境变量设置：
  运行测试前执行：

export DOCKER_HOST="unix:///Users/你的用户名/Library/Containers/com.docker.docker/Data/docker.sock"
# 或TCP方式
export DOCKER_HOST="tcp://localhost:2375"

开启TCP暴露：打开Docker Desktop -> Settings -> General，勾选Expose daemon on tcp://localhost:2375 without TLS。

3. 配置IntelliJ IDEA连接Docker #

在IDEA中直接选择适配Mac的Docker配置：

1. 打开Preferences -> Build, Execution, Deployment -> Docker；
2. 点击+添加配置，选择Docker for Mac选项，IDEA会自动识别正确的套接字路径；
3. 若自动识别失败，手动输入路径：unix:///Users/你的用户名/Library/Containers/com.docker.docker/Data/docker.sock；
4. 点击Test Connection验证连接成功。

4. 废弃Docker Machine #

Docker Machine基于VirtualBox，完全不适配ARM架构Mac，无需尝试创建或使用，直接使用Docker Desktop内置的虚拟机即可满足所有需求。

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