Intellij Docker连接测试成功但运行时报Not connected to Docker错误

• 确认Docker Desktop运行状态
  配置页连接测试仅代表测试时连接正常，运行配置时会重新发起连接请求，如Docker Desktop中途后台退出、更新后未重启都会触发该报错。打开Docker Desktop确认服务完全启动（状态栏显示Docker running）后再重试。
• 校验运行配置的Docker服务绑定
  打开Docker运行配置编辑页，确认Docker server下拉框选中的是你已测试连接成功的macOS默认Docker服务，避免误选其他无效的远程Docker服务配置。
• 重置Docker连接缓存
  打开IntelliJ偏好设置（Preferences → Build, Execution, Deployment → Docker），选中对应macOS Docker服务后点击移除，重新添加默认Docker服务，测试连接成功后保存配置，重启IntelliJ再运行即可。
• 放开Docker Desktop权限限制
  打开Docker Desktop设置页，进入Advanced标签，勾选Allow the default Docker socket to be used (requires password)，避免IntelliJ调用Docker接口时被系统权限拦截。
• 版本适配修复
  2023.1之前的IntelliJ版本对新版本Docker Desktop存在适配bug，会偶发连接测试通过但运行时断连的问题，升级IntelliJ到2023.1及以上版本即可解决。

Docker镜像调试步骤 #

1. 在Dockerfile中添加对应语言的调试参数配置，暴露调试端口
2. 打开Docker运行配置的Bind ports设置，将容器内的调试端口映射到本地空闲端口
3. 新建IntelliJ远程调试配置，绑定上一步映射的本地端口，启动Docker镜像后即可像本地程序一样打断点调试

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