fiber应用docker化失败90%因监听127.0.0.1:3000而非:3000；须分阶段构建、禁用cgo、运行镜像用alpine非scratch、端口映射并验证netstat输出含*:3000。
直接说结论：Fiber 应用 Docker 化失败，90% 是因为监听地址写成了 127.0.0.1:3000，而不是 :3000（等价于 0.0.0.0:3000）；其余关键点是构建阶段禁用 CGO、运行阶段别用 scratch、容器启动时必须映射端口并验证绑定状态。
为什么 curl 宿主机连不上容器里的 Fiber？
最常见错误是代码里显式绑定了回环地址：
-
app.Listen("127.0.0.1:3000")→ 只接受容器内部请求，外部网络根本收不到包 -
app.Listen(":3000")→ ✅ 正确，Go 默认解析为0.0.0.0:3000，可被 Docker 网络转发 - 环境变量拼接地址（如
HOST=$HOST PORT=$PORT）导致最终变成127.0.0.1:3000，也属于隐性错误
验证方式：容器启动后执行 docker exec -it <container> sh -c "netstat -tuln | grep :3000"</container>，输出中必须含 *:3000，不能是 127.0.0.1:3000。
Dockerfile 必须做对的三件事
Go 是编译型语言，Dockerfile 分两阶段构建不是“可选”，而是避免运行时依赖错乱的底线：
- 构建阶段用
golang:1.20-alpine（匹配go.mod的 Go 版本），加CGO_ENABLED=0 GOOS=linux，否则二进制在 Alpine 上跑会报no such file or directory - 运行阶段用
alpine:3.20（别用scratch），Fiber 的pprof、日志轮转、调试信号都依赖基础系统工具 -
COPY --from=builder只复制最终二进制（如./fiber-app），不带源码、go.mod或构建缓存，减小体积且防信息泄露
docker run 容易漏的关键参数
光有 -p 3000:3000 不够，生产环境至少补两个：
-
--restart=unless-stopped：防止宿主机重启后服务没起来，这是线上稳定性基本要求 -
--health-cmd="curl -f http://localhost:3000/health || exit 1"：配合 Fiber 写的健康路由（如app.Get("/health", func(c *fiber.Ctx) error { return c.SendStatus(fiber.StatusOK) })），让 Docker 能感知进程是否真活着 - 别省略
-d（后台运行）和--name（方便后续docker logs -f查日志）
真正卡住人的地方往往不在代码，而在 netstat 那行输出——看到 127.0.0.1:3000 就别往下折腾网络策略或防火墙了，先改监听地址。
