Docker容器中Delve无法生成__debug_bin文件报错求助

核心原因 #

这个错误大多是容器缺少调试所需的系统权限，或者基础镜像兼容性问题导致Delve无法生成调试二进制文件并启动进程。

分步解决方案 #

1. 给容器添加调试权限 #

Delve需要ptrace系统调用权限，默认Docker容器会限制这个权限。在docker-compose.yml中添加以下配置：

billing:
    image: my/image
    restart: unless-stopped
    depends_on:
        db:
            condition: service_healthy
    volumes:
        - .:/my/project/path
    ports:
        - "${DEV_ENV_HOST:-0.0.0.0}:9800:9800" # main app port
        - "${DEV_ENV_HOST:-0.0.0.0}:40000:40000" # debugger port
    # 添加调试权限二选一即可
    privileged: true  # 最简单的方式，授予容器所有权限
    # 或者更精细的权限控制
    # cap_add:
    #   - SYS_PTRACE
    security_opt:
      - seccomp:unconfined  # 关闭seccomp限制，允许调试相关系统调用

2. 更换兼容的基础镜像 #

如果使用Alpine这类轻量镜像，其musl libc可能与Delve存在兼容性问题。建议换成Debian/Ubuntu系的官方Go镜像：

# 替换原有基础镜像，比如用golang:1.21-bookworm（根据你的Go版本调整）
FROM golang:1.21-bookworm

# 后续安装步骤不变
RUN go install github.com/go-delve/delve/cmd/dlv@latest
RUN go mod vendor
RUN go install -gcflags="all=-N -l" -ldflags "-X main.version=$BUILD_VERSION" ./cmd/billing

3. 调整Delve的使用方式 #

避免依赖dlv debug自动生成__debug_bin，手动编译调试版本后再启动Delve：

1. 在容器内手动编译调试二进制：

go build -gcflags="all=-N -l" -o billing-debug ./cmd/billing

2. 用dlv exec启动调试：

dlv exec --headless --listen=:40000 --api-version=2 --accept-multiclient --check-go-version=false ./billing-debug

4. 修复目录权限问题 #

挂载本地目录后，容器内用户可能没有写入权限生成__debug_bin：

• 在Dockerfile中创建与本地用户UID一致的非root用户：

ARG USER_UID=1000
ARG USER_GID=1000
RUN groupadd -g $USER_GID appuser && useradd -u $USER_UID -g appuser appuser
USER appuser

• 或者启动容器时指定用户：

billing:
    # ...其他配置
    user: "${UID}:${GID}"

5. 更新Delve版本 #

旧版Delve可能存在兼容性问题，改用go install安装最新版：

# 替换原有go get命令
RUN go install github.com/go-delve/delve/cmd/dlv@latest

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