微容器中不能用 apt 安装 Fiber，须在构建阶段通过 Go 模块集成；常见失败原因包括缺 git、CA 证书和 GOPROXY；推荐多阶段构建，CGO_ENABLED=0 编译静态二进制，镜像可小于 15MB。
微容器内不能直接“安装”Fiber——它不是系统级包，而是 Go 语言的 HTTP 框架，需通过 Go 模块管理集成。 试图用 apt install fiber 或类似命令会失败，这是最常踩的第一个坑。
为什么 go get github.com/gofiber/fiber/v2 在微容器里容易卡住
微容器（如轻量 Alpine 镜像、Distroless、或极简 init 容器）通常：
• 缺少 git 二进制，导致 go get 无法 clone 仓库
• 没有 CA 证书包（ca-certificates），HTTPS 请求直接报 x509: certificate signed by unknown authority
• 不含 GOPROXY 默认值，又没配环境变量，会直连 GitHub 超时
实操建议：
- 不要在容器运行时执行
go get；所有依赖必须在构建阶段（Dockerfile中）完成 - 使用官方推荐的模块初始化方式：
go mod init myapp && go mod tidy，而非go get - 强制设置代理：
ENV GOPROXY=https://proxy.golang.org,direct（国内可换为https://goproxy.cn） - Alpine 镜像务必加：
RUN apk add --no-cache git ca-certificates
最小可行 Dockerfile：从 scratch 启动 Fiber 服务
目标是二进制无依赖、镜像小于 15MB。关键不在“安装”，而在“编译+剥离”：
FROM golang:1.23-alpine AS builder RUN apk add --no-cache git ca-certificates WORKDIR /app COPY go.mod go.sum ./ RUN go mod download COPY . . RUN CGO_ENABLED=0 GOOS=linux go build -a -ldflags '-s -w' -o /fiber-app . FROM scratch COPY --from=builder /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/ COPY --from=builder /fiber-app / EXPOSE 3000 CMD ["/fiber-app"]
注意点：
-
CGO_ENABLED=0是必须的，否则二进制会动态链接 libc，scratch镜像跑不起来 -
-ldflags '-s -w'剥离调试符号，减小体积约 30% - 只拷贝 CA 证书，不装完整
ca-certificates包，避免引入多余文件
如何验证 Fiber 真正跑在微容器里
别只看 docker run 不报错——要确认三件事：
- 容器进程树只有 1 个
/fiber-app，没有sh、bash或其他辅助进程（用docker top查） - 用
docker exec -it确认根目录下只有ls / fiber-app和etc/ssl/certs/ca-certificates.crt - 访问
curl -v http://localhost:3000，响应头中应含Server: Fiber，且无任何中间件注入痕迹（比如没被 nginx 或 traefik 重写）
真正容易被忽略的是：Fiber 的 app.Use(logger.New()) 默认会写 stdout，但在 Distroless 或 scratch 容器里，若日志驱动没配好，你会收不到任何请求记录——这不是框架问题，是容器运行时日志采集链路断了。
