GoLand中Docker构建与运行失败的根本原因及解决方案：1. 构建失败因上下文路径错误或.dockeringore误删go.mod，需校准Context目录或调整忽略规则；2. 容器服务不可访问因监听地址未设为0.0.0.0:8080；3. Compose中Go连PostgreSQL失败因启动顺序问题，需配置healthcheck与depends_on；4. Docker插件无法识别Docker Desktop因API连接方式错误，应改用TCP socket并启用Docker Desktop远程访问。
GoLand里直接构建镜像失败，docker build 报错找不到 go.mod
常见现象是点击 GoLand 的 “Dockerfile” 右键 → “Build Image”，结果提示 no required module provides package main 或 go: no go files in current directory。根本原因不是 GoLand 本身有问题，而是它默认在项目根目录执行 docker build，但你的 Dockerfile 如果放在子目录（比如 deploy/Dockerfile），或者 .dockerignore 误删了 go.mod，就会导致构建阶段读不到模块信息。
实操建议：
- 确认
Dockerfile和go.mod在同一级目录，或在 GoLand 的 “Build Image” 对话框中手动指定Context directory（即构建上下文路径，通常就是项目根目录） - 检查
.dockerignore文件，确保没写go.mod、go.sum或**/*.go这类误杀规则 - 如果必须把
Dockerfile放在子目录，用命令行验证：进入项目根目录后运行docker build -f deploy/Dockerfile .，成功后再同步到 GoLand 配置里
GoLand 启动容器后服务访问不了，curl localhost:8080 超时
这几乎一定是 Go 程序监听地址没设对。GoLand 默认只是把容器跑起来，不会自动检查你的代码是否绑定到了 0.0.0.0:8080 —— 很多人本地测试用 localhost:8080 没问题，但容器里 localhost 指的是容器自身，外部根本连不进来。
实操建议：
- 检查
http.ListenAndServe的第一个参数，必须是":8080"或"0.0.0.0:8080"，不能是"127.0.0.1:8080" - 在 GoLand 的 “Run Configuration” 里，确认 Docker 设置里的 “Port mappings” 正确填写了
8080:8080（左边宿主机端口，右边容器内端口） - 启动后先看容器日志：
docker logs <container-id>，确认程序是否真启动了，有没有 panic 或配置加载失败
GoLand 中配置 Docker Compose 启动多服务时，Go 服务连不上 PostgreSQL
典型错误是 dial tcp 172.18.0.2:5432: connect: connection refused，说明 Go 应用启动太快，PostgreSQL 容器还没初始化完。GoLand 调用 docker-compose up 时默认不等依赖服务就绪，和 CLI 行为一致。
实操建议：
- 在
docker-compose.yml的 Go 服务项里加depends_on并配合健康检查，例如：
services:
app:
build: .
depends_on:
db:
condition: service_healthy
db:
image: postgres:15
healthcheck:
test: ["CMD-SHELL", "pg_isready -U postgres"]
interval: 30s
timeout: 10s
retries: 5
- Go 代码里不要硬编码
localhost:5432，改用环境变量，如os.Getenv("DB_HOST")，并在 compose 中通过environment或env_file注入DB_HOST=db - GoLand 的 “Services” 工具窗口能实时看到各容器状态，绿色 ✅ 才代表健康就绪，别急着调接口
GoLand 自带的 Docker 插件无法识别本地 Docker Desktop
GoLand 启动时报错 Cannot connect to the Docker daemon at unix:///var/run/docker.sock，即使 Docker Desktop 已启动。这是因为 macOS / Windows 上 Docker Desktop 不暴露 Unix socket，而是走 TCP 接口，GoLand 默认仍尝试 Unix 域套接字。
实操建议：
- 打开 GoLand → Preferences → Build, Execution, Deployment → Docker，把 “Docker engine API” 从 “Unix socket” 改成 “TCP socket”，URL 填
tcp://localhost:2375 - 在 Docker Desktop 设置里开启 “Expose daemon on tcp://localhost:2375”，并勾选 “Allow access from external tools”（macOS/Windows 必须开）
- 如果用了 WSL2，注意 GoLand 运行在 Windows 主系统，要确保 WSL2 的 Docker daemon 已配置好远程访问，或干脆在 Windows 上装 Docker Desktop
真正麻烦的不是配置步骤，而是每个环节都依赖前一个环节正确：Docker daemon 可连 → 构建上下文完整 → 程序监听地址对外 → 依赖服务健康就绪。漏掉任意一环，GoLand 里点“运行”只会给你一个安静的失败。
