Docker容器运行Gin框架Go服务启动正常但请求无响应

服务无法访问由两个核心问题共同导致：

• 应用监听地址配置错误：代码中Gin服务绑定的是127.0.0.1:3000，该地址属于容器内部的回环地址，仅容器内部进程可访问，无法接收容器外部的流量。本地直接运行时127.0.0.1对应宿主机回环网卡因此访问正常，容器使用独立网络命名空间，该绑定地址无法对外提供服务。
• 容器启动未配置端口映射：Docker默认做网络隔离，即便服务监听地址正确，不配置宿主机到容器的端口映射，宿主机上的流量也无法转发到容器内部的服务端口。
  另外原Dockerfile的CMD写法存在信号转发隐患，依赖文件复制顺序未利用构建缓存，会导致后续构建速度变慢。

1. 修改Go代码的监听地址，将服务绑定到所有网卡的3000端口，修改后核心代码如下：

package main

import "github.com/gin-gonic/gin"

func main() {
    server := gin.Default()
    server.GET("/", func(ctx *gin.Context) {
        ctx.JSON(200, "HELLO SERVER")
    })
    // 绑定0.0.0.0替代127.0.0.1
    server.Run("0.0.0.0:3000")
}

2. 优化Dockerfile配置，调整依赖复制顺序利用构建缓存，修正CMD写法：

FROM golang:1.18.3-alpine3.16

WORKDIR /app

# 优先复制依赖声明文件，代码变更时不会重复执行依赖下载
COPY go.mod go.sum ./
RUN go mod download

COPY . .
RUN go build -o main .

EXPOSE 3000

# 使用exec格式启动，保证容器内进程可以正确收到系统信号
CMD ["./main"]

3. 重新构建镜像：

docker build -t gin-demo .

4. 启动容器时添加端口映射参数，将宿主机3000端口映射到容器3000端口：

docker run -d -p 3000:3000 gin-demo

如果完成上述操作后仍无法访问，依次检查：

• 宿主机3000端口是否被其他进程占用，若被占用可修改映射规则为-p 3001:3000，之后通过宿主机3001端口访问服务
• 检查本机防火墙/安全组规则是否拦截了3000端口的入站流量
• 进入容器内部执行wget http://127.0.0.1:3000，确认服务本身在容器内可正常响应

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