根本原因是未处理调试符号、cgo依赖和copy过度：需共用-go build -ldflags="-s -w"清除调试段，cgo_enabled=0确保静态链接，copy必须用绝对路径且避免冗余文件。
为什么 Go 多阶段构建后镜像还是超 50MB？
常见现象是：用了 FROM golang:alpine AS builder + FROM scratch，但最终镜像仍比预期大很多。根本原因不是 Dockerfile 写错了，而是没处理好三类隐性膨胀源：调试符号、cgo 依赖、以及 COPY 过度。
Go 默认编译产物含 .debug_* 段和反射元数据，go build -ldflags="-s -w" 必须同时使用才真正清除；单独加 -s 后执行 readelf -S your-binary 仍能看到调试段。
-
CGO_ENABLED=0是静态链接前提，漏掉会导致二进制动态链接 libc，被迫用alpine替代scratch，体积直接涨 5MB+ -
COPY --from=builder时若路径写成./main（相对路径），Docker 会把整个构建上下文打包进去；必须用绝对路径，如/app/main - 如果项目用了
net/http并访问 HTTPS，scratch下无证书会导致 TLS 握手失败——得手动COPY /etc/ssl/certs/ca-certificates.crt或切回alpine:latest
gin/echo/fiber 等框架在多阶段中怎么避免 runtime panic？
这类 Web 框架本身不引入 cgo，但实际项目常间接触发：比如用 github.com/lib/pq（PostgreSQL 驱动）、go-sqlite3、或调用 user.Current() 获取用户名。一旦发生，scratch 镜像里直接 panic: user: unknown userid 1001，alpine 则可能 DNS 解析失败或时区错乱。
验证是否真静态链接：在构建阶段容器里运行 ldd /app/main，输出 not a dynamic executable 才安全；否则得查 go list -json | grep -i cgo 定位哪个依赖开了 cgo。
在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...
- 禁用
user.Lookup类函数，改用os.Getuid()+ 环境变量传入用户名 - 数据库驱动优先选纯 Go 实现：
pgx/v5（非lib/pq）、sqlc配合database/sql - 嵌入模板或静态资源（
embed.FS）时，确保COPY阶段把对应文件也复制到 builder 阶段的相同路径，否则运行时报fs: file does not exist
如何让多阶段构建快 3 倍且缓存更稳？
频繁改代码时，go mod download 和 go build 层常因 COPY . . 破坏缓存。关键不是删命令，而是调整 COPY 顺序和使用 --mount 缓存挂载。
Alpine 上 apk add 不是瓶颈，慢在模块下载和编译。把 go.mod 和 go.sum 单独 COPY 并 RUN go mod download，能保证依赖层独立缓存；后续代码变更不影响这一层。
- 构建阶段开头就
COPY go.mod go.sum ./，再RUN go mod download，之后才COPY . . - Docker 23.0+ 支持
--mount=type=cache,target=/go/pkg/mod，比传统 layer 缓存更可靠，尤其适合 CI 环境 - 避免在 builder 阶段
RUN go test——测试代码和依赖不该进最终镜像，另起 stage 或本地跑
scratch 镜像启动失败，该查什么？
别只看 docker logs 或 docker ps -a 的状态，scratch 下没有 shell，exec -it 进不去，错误往往静默退出。真实问题藏在二进制本身或缺失的运行时支撑上。
最有效的验证方式是：用 docker save your-image | tar -xO | tar -t | head -20 查 rootfs 内容，确认只有你明确 COPY 的文件；再用 file /path/to/binary 看是否标为 statically linked。
- HTTPS 请求失败？检查是否用了
http.DefaultTransport且未设置RootCAs，需手动加载证书 - 日志输出乱码或卡住？
scratch无/dev/stdout符号链接，Go 默认仍往那里写，但某些内核版本下会阻塞——加os.Stdout.Sync()或用log.SetOutput(os.Stderr) - 程序启动即 exit 0？可能是
main()执行完就退了，Web 框架没绑定端口或http.ListenAndServe被 panic 拦截，加log.Fatal(http.ListenAndServe(...))捕获真实错误
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
