goland 远程联调必须通过 ssh 启动远程 dlv 进程并建立双向通信，sftp 挂载仅支持编辑；需配置 permittunnel yes、allowtcpforwarding yes，使用 --headless --accept-multiclient 参数支持多服务调试，attach 模式适用于 systemd 管理的常驻进程，避免使用 remote development 插件。
GoLand 远程项目联调必须走 SSH，不是 SFTP
直接挂载远程文件系统（比如用 SFTP 模式打开项目）只能编辑、不能真正联调。GoLand 的调试器需要在远程服务器上启动 dlv（Delve）进程，并与本地 IDE 建立双向 dlv-adapter 通信通道，这只有通过 SSH 才能稳定维持。
常见错误现象：Failed to start debugging session、connection refused、断点不命中但控制台有输出。
- 确认远程服务器已安装
dlv：运行dlv version，若报错需执行go install github.com/go-delve/delve/cmd/dlv@latest - 确保
sshd_config中启用PermitTunnel yes和AllowTcpForwarding yes - GoLand 新建 Remote Host 配置时，不要勾选 “Synchronize files on save”，改用 “Deploy” + “After launch” 自动上传构建产物
- 调试配置里 Target path 必须填远程绝对路径，例如
/home/user/myproject/cmd/api/main.go，不能是相对路径或本地路径
多服务联调时，dlv 启动参数必须加 --headless --api-version=2 --accept-multiclient
分布式项目通常含多个微服务（如 auth、order、user），每个都要独立调试。默认 dlv 启动后只接受一次连接，第二次会拒绝 —— 这就是你切服务时调试突然失效的根源。
正确做法是在 GoLand 的 Run Configuration → Go Tool Arguments 中填入：
dlv debug --headless --api-version=2 --accept-multiclient --continue --listen=:2345 --output=./bin/api
-
--headless：禁用交互式终端，专供 IDE 调试 -
--accept-multiclient：允许多个 IDE 实例（或多次重连）接入同一 dlv 进程 -
--listen=:2345：端口必须与 GoLand Debug Configuration 中的 Port 一致，且该端口需在服务器防火墙放行 - 避免使用
--continue导致程序飞速启动跳过断点，可改为--only-same-user加强安全限制
跨服务调用链调试：依赖 dlv 的 attach 模式 + 进程 PID 定位
当 order 服务调用 user 服务失败，你想在 user 服务里断点看入参，但 user 是由 systemd 或 supervisor 管理的常驻进程 —— 此时不能用 dlv debug，得用 dlv attach。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
操作步骤：
- 在服务器上查目标进程 PID：
pgrep -f "user-service" - 用
dlv attach <pid> --headless --api-version=2 --accept-multiclient --listen=:2346</pid> - GoLand 新建 Attach to Process 配置，Host 填服务器 IP，Port 填
2346，点击 Debug - 注意：attach 后无法修改代码再热重载，所有断点需在 attach 前设好；且
dlv版本必须与被调试二进制的 Go 版本兼容（如 Go 1.22 编译的程序，不能用 Go 1.21 的 dlv attach）
本地+远程混合联调：别碰 “Remote Development” 插件
JetBrains 官方 Remote Development 插件（基于 Gateway）对 Go 项目支持极差，常出现 dlv not found in PATH、cannot resolve GOPATH 等错误，且无法识别 go.work 文件。
更可靠的做法是分层处理：
- 本地跑 gateway / api-gateway 类服务（依赖少、启动快），用
dlv test或普通 Debug - 真实下游服务（如 payment、inventory）全部署到远程服务器，用上述 SSH + dlv attach 方式接入
- 用
curl或 Postman 手动触发本地 gateway 调用远程服务，观察两端日志和断点行为 - 若需查看完整调用链，建议在代码中加
fmt.Printf("trace_id: %s, service: user, input: %+v\n", traceID, req)，比依赖 IDE 可视化更稳
真正卡住的往往不是配置步骤，而是 dlv 进程权限、SELinux 上下文、以及 GoLand 启动调试时自动注入的环境变量覆盖了 GOPATH 或 GOBIN —— 这些细节一旦出错，断点就永远灰着。
