必须加cgo_enabled=0，否则go二进制默认依赖glibc，而alpine使用musl libc、scratch甚至无libc，导致运行时报“no such file or directory”——实为动态链接器缺失而非路径错误。
CGO_ENABLED=0 必须加，否则 Alpine/scratch 镜像直接报错
不加 CGO_ENABLED=0，Go 编译出的二进制默认依赖 glibc；而 Alpine 用的是 musl libc，scratch 镜像甚至没有 libc —— 运行时就会出现 standard_init_linux.go:228: exec user process caused: no such file or directory 这类错误，不是路径不对，是根本找不到动态链接器。
- 必须在构建阶段显式设置：
CGO_ENABLED=0 GOOS=linux go build -o main . - 如果用了
go build -a -installsuffix cgo，本质仍是启用 CGO，不能替代CGO_ENABLED=0 - 即使你用 Ubuntu 基础镜像跑，也建议关掉 CGO：体积更小、无 libc 版本兼容风险、能直接进
scratch
监听地址必须是 0.0.0.0:8080，不是 127.0.0.1:8080
Kubernetes Pod 的 IP 是分配给容器网卡的真实地址，Service 流量通过 kube-proxy 转发到该 IP。若 Go 服务只监听 127.0.0.1:8080，外部流量根本进不来，readinessProbe 持续失败，Pod 会被反复重启。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 启动 server 时写死
":8080"或"0.0.0.0:8080"，不要拼接 host 字符串 - 检查代码里是否有类似
http.ListenAndServe("127.0.0.1:8080", handler)—— 这是常见硬编码坑 - Dockerfile 中
EXPOSE 8080只是文档作用，不改变监听行为；真正起效的是 Go 代码里的绑定地址
readinessProbe 和 livenessProbe 路径必须真实存在且逻辑分离
Kubernetes 不靠进程存活判断健康，而是 HTTP 探针轮询指定路径。很多 Go 服务只写了 /，但没暴露 /readyz 或 /healthz，导致探针 404，Pod 卡在 ContainerCreating 或反复重启。
-
readinessProbe应检查服务是否就绪（如 DB 连通、配置加载完成），路径如/readyz -
livenessProbe应检查进程是否卡死（轻量级心跳），路径如/healthz，不应包含耗时操作 - K8s YAML 中必须设
initialDelaySeconds（建议 ≥15s），留给 Go 服务完成初始化（DB 连接、缓存预热等） - 探针路径要在 Go 代码里显式注册：
http.HandleFunc("/readyz", ...)，不能只靠中间件路由自动 fallback
非 root 用户 + scratch/alpine 是安全底线，不是可选项
用 golang:alpine 直接运行二进制，等于把 Go 工具链、apk 包管理器、shell 全塞进生产镜像——攻击面大、体积大、违反最小权限原则。
- 第二阶段优先选
FROM scratch：最终镜像仅含二进制，通常 - 若需证书或时区支持，改用
alpine:latest并加RUN apk --no-cache add ca-certificates tzdata - 必须配
USER：比如RUN adduser -D -u 65532 appuser && USER appuser，避免容器逃逸后获得 root 权限 -
CMD ["./main"]不要用sh -c "./main"，防止绕过 USER 限制
curl http://localhost:8080/readyz 返回 200，且响应体不含 HTML 或重定向。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
