GoLand远程调试不支持多跳链路，因配置仅接受单层host+port，必须用ssh -J或嵌套-L将目标dlv端口逐级映射至本地；调试时host填127.0.0.1、port填本地映射端口，并正确配置substitutePath以匹配源码路径。
GoLand 无法直连多跳环境下的 Go 进程，必须靠本地端口逐级转发，且每层 ssh 命令的 -L 和 -J（或嵌套）用法要严格匹配目标地址解析范围。
为什么不能直接填跳板机之后的服务器地址
GoLand 的远程调试配置只支持单层 host + port，它不理解“先连 A，再从 A 连 B”这种链路。如果你在 launch.json 或 GoLand 的 Debug Configuration 里把 host 设成内网服务器 IP（比如 10.0.1.5），GoLand 会尝试直接连这个地址 —— 显然失败，因为本地根本路由不到。
真正可行的路径是：本地 → 跳板机（Bastion）→ 目标服务器（Target）。这需要把 Target 上的 dlv 监听端口（如 2345），一层层映射回本地一个可访问的端口（如 12345）。
常见错误现象：
- GoLand 报错
connection refused或超时，但telnet localhost 12345也通不了 —— 说明隧道根本没建好 - 能连上，但断点不命中 —— 很可能是
substitutePath没适配多跳后的源码路径映射，或dlv启动时用了相对路径导致调试器读不到源码
用 ssh -J 一次性建立两级隧道（推荐）
OpenSSH 7.3+ 支持 -J 参数，比写两层 ssh -L 嵌套更简洁、更可靠。假设：
- 跳板机地址：
bastion.example.com，用户：jumpuser - 目标服务器地址：
app-server（在跳板机上可解析），用户：appuser - 目标上
dlv已监听127.0.0.1:2345
在本地终端执行：
ssh -L 12345:127.0.0.1:2345 -J jumpuser@bastion.example.com appuser@app-server
这条命令含义是：
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 先通过
jumpuser@bastion.example.com登录跳板机 - 再从跳板机发起连接到
appuser@app-server - 同时把本地
12345端口，经跳板机转发到app-server的127.0.0.1:2345
注意：app-server 必须对跳板机可解析（/etc/hosts 或 DNS），且 dlv 必须监听 127.0.0.1:2345（不是 0.0.0.0 或主机名），否则跳板机无法反向连过去。
GoLand 中配置调试器指向本地映射端口
隧道建立后，GoLand 就当它是本地服务来连：
-
host填127.0.0.1（不是跳板机或目标服务器地址） -
port填你本地映射的端口，即上面例子中的12345 -
substitutePath必须反映源码在目标服务器上的绝对路径，例如：- 目标服务器上代码在
/home/appuser/myapp - 你本地克隆在
/Users/me/src/myapp - 则配置：
"substitutePath": [ { "from": "/home/appuser/myapp", "to": "/Users/me/src/myapp" } ]
- 目标服务器上代码在
- 如果目标服务器是容器，且源码挂载在
/app，而你本地路径是~/projects/myapp，那from就得写容器内路径/app，不能写宿主机路径
容易被忽略的一点：dlv 启动命令必须带 --headless --continue --accept-multiclient，否则首次连接后就退出，第二轮调试失败。
替代方案：手动串接两层 ssh -L（兼容老版本 SSH）
若 SSH 版本低于 7.3，或需更精细控制每层行为，可用嵌套方式：
# 第一层：本地 → 跳板机，把本地 2222 映射到跳板机的 2222 ssh -L 2222:127.0.0.1:2222 jumpuser@bastion.example.com <h1>第二层：在跳板机上执行（新开终端或 <code>ssh -t</code> 进去），把跳板机 2222 → 目标 2345</h1><p>ssh -L 2222:127.0.0.1:2345 appuser@app-server
然后在 GoLand 中连 127.0.0.1:2222。这种方式调试时一旦某层断开，整个链路就失效，不如 -J 自动维护稳定。
最后提醒：多层隧道下，dlv 日志输出和 stderr 默认不会透传到 GoLand 控制台，查问题得登录目标服务器看 dlv 进程是否真在跑、有没有报 could not launch process 这类启动失败信息 —— 这往往是编译时没加 -gcflags="all=-N -l" 或二进制权限不对导致的。
