Fiber 是 Go 框架而非运行时依赖，容器中只需静态编译的二进制文件；构建阶段用多阶段 Dockerfile（golang:alpine 构建、alpine:3.19 运行），禁用 CGO，添加 ca-certificates，使用 fiber.New() 配置生产选项，最终镜像应 ≤12MB 且 ldd 显示静态链接。
容器里不装Fiber，只打包编译好的二进制
Fiber 是 Go 语言框架，不是运行时依赖，容器里不需要“安装”它。你真正要做的，是在构建阶段用 go build 编译出静态二进制，然后在极简运行环境中直接执行。试图在 Alpine 容器里 go get github.com/gofiber/fiber/v2 是典型误区——既浪费镜像体积，又引入不必要的 Go 工具链和构建依赖。
关键点：
- 所有依赖（包括
fiber）必须在构建阶段通过go mod download和go build解决，运行镜像里只留一个可执行文件 - 务必加
CGO_ENABLED=0，否则二进制可能在 Alpine 上因缺失 libc 而 panic：failed to load system cert pool - 别用
golang:alpine直接跑服务——它含go、git、gcc等几十个非必要包，镜像体积超 300MB，且存在 CVE 风险
多阶段 Dockerfile 必须写对这三行
以下是最小可行的多阶段构建结构，省略注释，只保留不可删减的核心指令：
# 构建阶段 FROM golang:1.22-alpine AS builder WORKDIR /app COPY go.mod go.sum ./ RUN go mod download COPY . . RUN CGO_ENABLED=0 GOOS=linux go build -a -o ./server . <h1>运行阶段</h1><p>FROM alpine:3.19 RUN apk add --no-cache ca-certificates WORKDIR /app COPY --from=builder /app/server . EXPOSE 3000 CMD ["./server"]</p>
常见翻车点：
-
RUN apk add --no-cache ca-certificates不能漏：fasthttp 默认不走系统证书池，但若你的 Fiber 服务需调用 HTTPS 外部 API（比如阿里云 SDK），没这个包就会x509: certificate signed by unknown authority -
COPY --from=builder路径必须严格匹配，/app/server和./server少一个斜杠或拼错名，容器启动就报exec: "./server": stat ./server: no such file or directory -
EXPOSE只是文档性声明，不打开端口；实际映射靠docker run -p 3000:3000，别指望它自动生效
fiber.New() 是生产环境唯一合法入口
如果你在 main.go 里还写着 app := fiber.Default()，容器一启动就等于把敏感头往日志里倒。它默认挂载的 Logger 中间件会完整打印 Authorization、Cookie 等字段，每秒几百次请求就是几百次磁盘 I/O 写入。
正确做法：
- 上线前必须替换为
app := fiber.New(fiber.Config{...}) - 显式关闭日志：
DisableStartupMessage: true（避免首启刷屏干扰健康检查） - 如需错误日志，用
app.Use(func(c *fiber.Ctx) error { ... })拦住c.Response().StatusCode() >= 400的响应再写，别碰fiber.Logger() - StrictRouting 保持默认
true，不要设false—— 否则/users会意外匹配/users/123，c.Params("id")拿不到值
验证镜像是否真“极简”
构建完别急着推 registry，先本地验证体积和行为：
- 运行
docker images | grep fiber，确认镜像大小 ≤ 12MB（Alpine 基础 + 二进制） - 执行
docker run --rm -p 3000:3000 fiber-app:latest，立刻curl -v http://localhost:3000/health，看是否返回 200 且无多余 header - 进容器查进程：
docker exec -it，应只看到一个ps aux ./server进程，没有sh、apk或其他残留 - 最易忽略的一点：检查
server是否真的静态链接——docker run --rm fiber-app:latest /bin/sh -c "ldd ./server"应输出not a dynamic executable
