根本原因是dlv默认监听localhost或容器内网卡地址，而网关代理转发后请求来源为网关IP，dlv无法自动关联；需将--addr设为0.0.0.0:2345、开放端口并配置GoLand连接容器网络可达地址。
GoLand 调试容器内服务时，网关代理转发导致断点不命中
根本原因是：GoLand 的调试器（dlv）默认只监听 localhost 或容器内网卡地址，而网关代理（如 Nginx、Traefik 或 API 网关）转发请求后，实际请求来源是网关容器 IP，不是本地 IDE 发起的调试连接。dlv 不会把“被代理进来的 HTTP 请求”和当前调试会话自动关联。
解决思路不是改网关，而是让 dlv 主动暴露可被网关容器访问的监听地址，并确保 GoLand 连接的是这个地址。
- 启动容器时，用
-delve --headless --continue --accept-multiclient --api-version=2 --addr=:2345参数运行 dlv，且--addr必须绑定到0.0.0.0:2345（不能是127.0.0.1:2345） - Dockerfile 中确保开放调试端口：
EXPOSE 2345，并检查docker run是否加了-p 2345:2345 - 网关配置里，若做了 host rewrite 或 header 透传（比如
X-Forwarded-For），不影响 dlv 工作，但会影响你日志中看到的 client IP —— 这和调试无关，别混淆
GoLand 配置 Remote Debug 时，连接地址填什么
填容器网络视角下的可达地址，不是宿主机的 localhost。
常见组合：
- 使用
docker-compose：填host.docker.internal:2345（Docker Desktop 默认支持；Linux 上需手动加--add-host=host.docker.internal:host-gateway） - 纯
docker run+ bridge 网络：填宿主机真实 IP（如192.168.1.100:2345），不能填localhost或127.0.0.1 - 使用 Kubernetes + Port Forward：先执行
kubectl port-forward pod/myapp 2345:2345，GoLand 中填localhost:2345
如果填错，GoLand 会报错：Unable to connect to debugger 或 Connection refused，不是证书或超时问题。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
网关转发路径中，如何确认请求真进了被调试的 Go 服务
靠日志，别靠浏览器状态栏或 curl 返回码。因为网关可能缓存、重试、静默降级，而 dlv 断点只在 Go runtime 执行到那行才触发。
- 在 handler 入口加一行
log.Printf("DEBUG: request arrived, path=%s", r.URL.Path)，确保它在 dlv 启动后、断点前就输出 - 用
docker logs -f <container-name>实时看日志，确认这行出现，再点 GoLand 的 “Debug” 按钮 - 避免在 middleware（如 JWT 验证、CORS）里设断点却忘了它们可能提前 return，导致后续 handler 根本不执行
典型陷阱：网关把 /api/v1/users 重写成 /users，但你的 Go handler 注册的是 /api/v1/users —— 请求 404，dlv 自然不会触发。
GoLand 2026.1+ 版本对容器调试的优化点
新版索引引擎和调试器内核改进，对容器调试最实在的提升是变量展开速度，尤其当你在断点处 inspect 一个从网关传入的 map[string]interface{} 或嵌套 json.RawMessage 时。
- 旧版（2025.3 及之前）：展开深度 >5 层的结构体，IDE 卡顿明显，有时直接无响应
- 新版（2026.1.1）：依赖图缓存使变量解析延迟下降约 40%，配合多线程解析，
ctx.Value()里塞的任意类型也能较快展开 - 但注意：这个优化不改变网络连接逻辑，
dlv还是得你自己配对 —— IDE 再快，连不上就是连不上
真正容易被忽略的点是：容器时间与宿主机不同步时，GoLand 的断点命中时间戳会乱序显示，看着像“跳过了断点”，其实是系统时间没校准。用 docker exec -it <container> date 和 date 对比一下。
