使用Goland远程调试Docker中Go应用失败求助

问题现象 #

按照官方步骤配置Goland远程调试Docker容器内的Go应用，点击调试按钮后立即显示“Remote process terminated”，容器内程序运行正常，但断点完全未触发。

环境信息 #

• Windows10 系统
• Goland 2022.1.3
• Docker Desktop v4.10.1

Dockerfile 内容 #

# 编译阶段
FROM golang:1.18 AS build-env

## 换国内源->构建调试工具Delve
RUN go env -w GOPROXY=https://goproxy.cn && \
    go install github.com/go-delve/delve/cmd/dlv@latest

## 将当前目录拷贝至目标容器
COPY . /tempdir
## 切换工作目录
WORKDIR /tempdir
## 编译go文件
RUN go build -o /tp -gcflags="all=-N -l" temp.go

# 运行阶段
FROM debian:buster
## 暴露调试的端口
EXPOSE 23555
WORKDIR /
## 将构建的编译镜像中的dlv调试工具程序和exp程序拷贝到当前容器
COPY --from=build-env /go/bin/dlv /
COPY --from=build-env /tp /
## 执行调试命令
CMD ["/dlv", "--listen=:23555", "--headless=true", "--api-version=2", "--accept-multiclient", "exec", \
"/tp", "100"]

Temp.go 代码 #

package main

import (
    "fmt"
    "os"
    "strconv"
)

func main() {
    if len(os.Args) < 2 {
        fmt.Println("need 1 args")
        os.Exit(1)
    }

    var s []int
    printSlice(s)

    // 添加一个空切片
    i, err := strconv.Atoi(os.Args[1])
    if err != nil {
        fmt.Println("arg 1 error")
        os.Exit(2)
    }
    s = append(s, i)
    printSlice(s)

    // 这个切片会按需增长
    s = append(s, 1)
    printSlice(s)

    // 可以一次性添加多个元素
    s = append(s, 2, 3, 4)
    printSlice(s)
}

func printSlice(s []int) {
    fmt.Printf("len=%d cap=%d %v\n", len(s), cap(s), s)
}

配置说明 #

• Goland中已配置Dockerfile构建镜像
• Go Remote调试配置指向本地23555端口

问题原因及解决方法 #

1. 端口未映射 #

Docker容器内的23555端口未映射到宿主机，导致Goland无法连接到容器内的Delve服务。

• 解决：运行容器时添加端口映射参数：

  docker run -p 23555:23555 [你的镜像名]
  

2. Delve版本不兼容 #

使用latest版本的Delve可能与Goland 2022.1.3存在兼容性问题，导致调试连接失败。

• 解决：安装与Goland版本匹配的Delve版本，例如v1.20.2：
  修改Dockerfile中安装Delve的命令：

  RUN go env -w GOPROXY=https://goproxy.cn && \
      go install github.com/go-delve/delve/cmd/dlv@v1.20.2
  

3. 容器缺少调试权限 #

Delve需要特定系统权限才能进行调试，默认容器权限不足会导致调试连接异常。

• 解决：运行容器时添加权限参数：

  docker run --cap-add=SYS_PTRACE -p 23555:23555 [你的镜像名]
  # 或使用特权模式（不推荐生产环境）
  docker run --privileged -p 23555:23555 [你的镜像名]
  

4. 调试配置地址错误 #

确认Goland的Go Remote配置中，Host设置为localhost，Port设置为23555，与端口映射保持一致。

5. 编译调试信息缺失 #

确认编译时的-gcflags="all=-N -l"参数生效，关闭了Go编译器的优化和内联，否则断点无法命中。

• 验证：可以在容器内执行dlv inspect /tp查看是否包含调试信息，若缺失则重新构建镜像。

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