断点不生效或连接被拒绝，主因是dlv启动参数（--headless=true --api-version=2）、容器sys_ptrace权限、二进制编译标记（-n -l）三者未对齐；需确保goland远程配置、源码路径映射及dlv版本一致。
能连上，但断点不生效或连接直接被拒绝，大概率是 dlv 启动参数、容器权限、二进制编译选项三者中至少有一处没对齐。
dlv 必须以 --headless=true --api-version=2 启动
GoLand 远程调试只兼容 Delve 的 headless 模式和 v2 API 协议。用错版本（比如 v1）或漏掉 --headless=true，IDE 就无法建立调试会话。
-
--headless=true是强制项，不是可选；--api-version=2从 dlv v1.7+ 起成为默认，但显式声明更稳妥 - 别用
dlv debug或dlv test—— 容器里只能跑dlv exec或dlv attach - 如果启动后看到
warning layer=rpc Listening for remote connections (connections are not authenticated nor encrypted)，说明监听已就绪，不是错误
容器必须有 SYS_PTRACE 权限且二进制带 -N -l 编译标记
没有 SYS_PTRACE，dlv attach 会失败；没加 -gcflags="all=-N -l" 编译，GoLand 找不到符号信息，断点灰掉或跳过。
- 在 Deployment 的
securityContext中显式声明：capabilities: {add: ["SYS_PTRACE"]}，不要依赖privileged: true（太宽泛，K8s 策略常禁用） - 构建时必须带
go build -gcflags="all=-N -l" -o main ./cmd/...；用make编译 Kubernetes 源码时，要改hack/lib/golang.sh去掉-s -w并加-N -l - 验证方法：在容器内执行
file /path/to/binary，输出含not stripped才算成功；若显示stripped，说明符号已被移除
GoLand Remote Debug 配置必须匹配容器监听地址和端口
GoLand 不会自动发现容器 IP 和端口，必须手动填对 —— 容器内监听的 :2345，不等于宿主机或本地能直连的地址。
- 先用
kubectl port-forward pod/<pod-name> 2345:2345</pod-name>把容器 2345 端口映射到本地；GoLand 的 Remote Debug 配置里 Host 填127.0.0.1，Port 填2345 - 别信 “容器 IP + NodePort” 组合 —— 大部分集群网络策略不允许 Pod IP 直连，NodePort 又常被防火墙拦截
- 如果用了 Sidecar 模式（dlv 和业务容器同 Pod），确保两个容器共享 network namespace，否则
localhost:2345在业务容器里根本连不到 dlv
GOPATH 和源码路径必须严格一致
GoLand 根据本地文件路径匹配远程二进制里的 debug 信息。路径差一级（比如本地是 /src/foo，容器里是 /go/src/foo），断点就失效。
- 同步代码时，用
scp -r或 Goland 的 Deployment 同步功能，目标路径必须和容器内dlv exec启动时的工作目录、以及go build的$GOPATH结构完全一致 - 常见坑：本地 GOPATH 是
/Users/me/go，远程设成/root/go，但 dlv 启动命令里写的是exec /root/go/src/.../main，而 Goland 默认按本地 GOPATH 映射 —— 得在 Run Configuration 里手动设置 “Remote path” 为/root/go - 用
dlv version检查两端 dlv 版本是否一致（尤其 v1.x 和 v2.x 兼容性差），不一致优先统一到 v1.21+
最易被忽略的是源码路径映射和 SYS_PTRACE 权限 —— 它们不出错日志，但直接让调试静默失败。动手前先在容器里 ls -l /proc/self/status | grep CapEff 看 cap 有没有 0000000000000000000000000000000000000000000000000000000000000400（对应 SYS_PTRACE），再确认本地路径和容器内 readelf -S /path/to/binary | grep debug 有 debug_* 段存在。
