GoLand调试微服务需显式配置运行上下文：在Run→Edit Configurations中新建Go Build配置，设置Environment variables（如PORT=8081;CONSUL_ADDR=consul:8500）、Working directory为服务根目录，并勾选Include OS environment variables；多服务需单独配置并分别启动或远程Attach；避免air与dlv混用导致断点失效。
GoLand 里调试微服务，别直接点“Debug”
直接右键 main.go → Debug，大概率会卡在 HTTP 启动、Consul 注册或 gRPC 服务绑定上——因为微服务依赖环境变量、外部地址、健康检查端口，IDE 默认不加载这些。必须显式配置运行上下文。
- 在
Run → Edit Configurations里新建一个Go Build配置，而不是用默认的 Go Application 模板 -
Program arguments留空（除非你代码里手动解析 flag）；重点填Environment variables：比如PORT=8081;CONSUL_ADDR=consul:8500;LOG_LEVEL=debug -
Working directory设为服务根目录（含go.mod），否则viper.ReadInConfig()找不到config.yaml - 勾选
Include OS environment variables—— 有些本地脚本（如make dev）会动态注入变量，不勾这个就全丢了
多服务联调时，断点只在当前服务生效
GoLand 的 Delve 调试器默认只 attach 当前进程。你在 user-service 打断点，order-service 请求过来时不会停；它只是个 HTTP 客户端，不是调试代理。
- 每个服务单独开一个 Run Configuration，分别启动、分别 Attach —— 别试图用一个配置跑多个服务
- 如果用 Docker Compose 启动，需在
docker-compose.yml中为每个服务加command: dlv --listen=:2345 --headless=true --api-version=2 --accept-multiclient exec ./app，然后在 GoLand 里新增Go Remote配置，Host 填localhost，Port 填对应服务映射的 2345（如ports: ["2345:2345"]） - 注意：容器内
dlv启动路径必须和WORKDIR一致，否则exec ./app找不到二进制文件
HTTP 调用链路断点失效？检查 Client 超时和 DNS 解析
你在 order-service 的 handler 里打了断点，但 auth-service 返回 404 或 timeout，断点根本没触发——问题不在断点本身，而在调用层。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
-
http.Client必须设超时：&http.Client{Timeout: 3 * time.Second}，否则断点卡住 30 秒才报错，你以为是网络问题，其实是没设 timeout 导致阻塞 - Docker 内调用宿主机服务时，别用
http://localhost:8080—— 容器里localhost是自己。Mac/Windows 用http://host.docker.internal:8080；Linux 用http://172.17.0.1:8080 - 如果用了 Consul 服务发现，确保
consul.Agent.ServiceRegister()成功返回，且服务名拼写全小写+短横线（auth-service✅，auth_service❌）
热重载 + 调试别混用，air 和 dlv 会冲突
air 监听文件变化自动重启进程，而 dlv 是 attach 到固定 PID。两者同时运行，air 一重启，dlv 就 detach，断点全部失效，还可能残留 zombie 进程。
- 开发阶段二选一：写逻辑用 air，查问题用 dlv；别在
.air.toml里配bin = "dlv --headless ... exec ./app" - 如果非要用热重载调试，改用 GoLand 自带的
File → Settings → Tools → File Watchers配go build+dlv exec组合，但稳定性不如纯 dlv - Delve 启动参数里加
--continue可让服务启动后自动运行，避免每次都要手动 resume
微服务调试真正的复杂点不在 IDE 设置，而在服务间依赖的真实状态：Consul 是否真注册成功、环境变量是否被某层 shell 截断、Docker network 是否隔离了 health check 流量——这些都得靠 curl <a href="https://www.php.cn/link/c0b9cc4a860c95fb6ca92d7fd9630cbe">https://www.php.cn/link/c0b9cc4a860c95fb6ca92d7fd9630cbe</a> 或 docker logs -f auth-service 实时验证，而不是只盯着 GoLand 的断点图标。
