容器内集成Delve调试Golang报/dlv不存在等错误的方案咨询

原有方案报错根因 #

• 多阶段构建方案报错：dlv debug命令的执行逻辑是调用本地Go工具链实时编译源码后挂载调试进程，你使用的ubuntu:18.04运行层未预装Go环境，自然找不到go可执行文件；同时跨镜像拷贝dlv二进制时，若基础镜像glibc版本和构建阶段不一致，还可能出现动态链接库缺失问题。
• 单阶段构建方案报错：go install安装的dlv默认存放路径为$GOPATH/bin/dlv，golang:1.17镜像默认GOPATH为/go，即dlv实际路径为/go/bin/dlv，你在CMD中写的/dlv路径不存在，导致启动失败。

可直接复用的配置（与本地调试体验完全一致） #

推荐使用单阶段构建，基于官方golang镜像无需额外处理依赖，配置如下：

FROM golang:1.17

WORKDIR /app
# 优先拷贝依赖文件利用Docker构建缓存
COPY go.mod go.sum ./
RUN go mod download

# 安装Delve，安装后二进制路径为/go/bin/dlv
RUN go install github.com/go-delve/delve/cmd/dlv@latest

# 拷贝项目源码
COPY go/app/parsedata-xml-fp.go .

# 将GOPATH/bin加入全局PATH，可直接调用dlv、go命令
ENV PATH="/go/bin:${PATH}"

EXPOSE 2345
# 启动后直接进入bash，可手动执行dlv命令，和本地终端操作逻辑完全一致
CMD ["/bin/bash"]

构建与启动步骤 #

1. 执行镜像构建命令：

docker build -t rss-dlv-debug -f Dockerfile.localmod .

2. 启动容器必须加ptrace权限参数，否则Delve无法挂载调试进程：

docker run -it --cap-add=SYS_PTRACE -p 2345:2345 rss-dlv-debug

3. 进入容器终端后，操作和本地完全一致，直接执行调试命令即可：

dlv debug parsedata-xml-fp.go

后续断点设置、步进调试等操作和你本地的操作流程无任何区别。

远程调试模式配置 #

如果需要从本地终端/IDE连接容器内的Delve服务，不需要进入容器交互，可将CMD替换为headless启动模式，注意路径填写正确：

CMD ["/go/bin/dlv", "--listen=:2345", "--headless=true", "--api-version=2", "--accept-multiclient", "debug", "/app/parsedata-xml-fp.go"]

容器启动后，本地执行dlv connect 127.0.0.1:2345即可接入调试会话。

关键注意事项 #

• Delve依赖ptrace系统调用实现进程挂载，启动容器时必须添加--cap-add=SYS_PTRACE或--security-opt=seccomp:unconfined参数，否则会报权限不足错误。
• 若坚持使用多阶段构建，运行层需要同时安装Go环境、匹配版本的glibc依赖，且需要保证源码路径和编译路径完全一致，否则会出现断点无法命中的问题，不如直接使用官方golang镜像作为运行层省心。
• 若使用dlv exec模式调试预编译二进制，编译时必须添加-gcflags="all=-N -l"参数禁用编译器优化和内联，否则断点、变量查看会出现异常。

内容的提问来源于stack exchange，提问作者Jia