容器中 runtime.GOMAXPROCS 易设错，因 Go 默认读宿主机 CPU 数而非容器限制值，导致线程过多、调度开销大、GC 停顿长；应通过 cgroup 或 GOMAXPROCS 环境变量显式设置为容器实际 CPU 配额。
为什么 runtime.GOMAXPROCS 在容器里经常被设错
Go 程序在 Docker 容器中默认会读取宿主机的 CPU 核心数来设置 GOMAXPROCS，而不是容器实际能用的 CPU 资源。比如宿主机有 32 核，但容器只限制了 --cpus=2，Go 仍可能启动 32 个 OS 线程，导致调度开销增大、GC 停顿变长、并发效率反降。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 显式设置
GOMAXPROCS：在main()开头调用runtime.GOMAXPROCS(runtime.NumCPU())不够安全，应改用runtime.GOMAXPROCS(int(numCPUs))，其中numCPUs从/sys/fs/cgroup/cpu/cpu.cfs_quota_us和/sys/fs/cgroup/cpu/cpu.cfs_period_us计算（Docker 旧版 cgroup v1）或/sys/fs/cgroup/cpu.max（cgroup v2） - 更简单可靠的方式是启动时传入环境变量：
GOMAXPROCS=2，Go 1.19+ 会自动识别并生效 - 验证是否生效：运行时打印
runtime.GOMAXPROCS(0)，值应与容器 CPU limit 一致
Docker 默认内存限制未触发 Go 内存回收
Go 的 GC 触发阈值（GOGC）默认基于堆增长比例，不感知容器内存限制。当容器设了 --memory=512m，但 Go 程序持续分配到 400MB 就可能因 OOM 被 kill，而 GC 还没触发——因为堆还没“翻倍”。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 配合内存限制设置
GOMEMLIMIT：例如GOMEMLIMIT=400MiB，Go 1.19+ 会主动控制堆大小，避免触达 cgroup limit 导致 OOM kill - 不要只依赖
GOGC调低（如GOGC=20），它无法防止突发分配打爆内存；GOMEMLIMIT是更直接的兜底机制 - 检查是否生效：观察
go tool trace中的 heap goal 曲线，或通过debug.ReadGCStats查看HeapGoal是否稳定在预期范围内
Alpine 镜像下 net/http DNS 解析慢且偶发超时
很多 Go 服务用 golang:alpine 构建镜像，但 Alpine 使用 musl libc，其 getaddrinfo 默认不支持并行解析，且对 /etc/resolv.conf 中多个 nameserver 的 fallback 行为与 glibc 不同，容易造成 HTTP 请求卡在 DNS 阶段。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 避免 Alpine，改用
golang:slim（deb-based，glibc）或官方推荐的gcr.io/distroless/static（无 libc 依赖，需静态编译） - 若必须用 Alpine，编译时加
-tags netgo强制使用 Go 自带 DNS 解析器（纯 Go 实现，支持并发 + timeout 控制） - 在代码中显式配置
http.DefaultClient.Transport的DialContext，设置Resolver并指定超时，避免依赖系统解析逻辑
docker build 多阶段构建未清理 CGO_ENABLED=1 的中间产物
常见写法是在 builder 阶段启用 CGO_ENABLED=1 编译 C 依赖（如 SQLite、OpenSSL），但 final 阶段若未显式关闭，Go 仍可能动态链接 libc，导致镜像体积膨胀、启动变慢，甚至在 distroless 镜像中 panic。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- final 阶段务必设置
CGO_ENABLED=0，再用go build -a -ldflags '-s -w'静态编译 - 检查二进制是否干净：运行
file your-binary应显示 “statically linked”；ldd your-binary应报 “not a dynamic executable” - 如果必须用 cgo（如需要
net包的系统 DNS），则 final 阶段至少要带libc6（如debian:slim），不能用 distroless
最易被忽略的是：性能问题往往不是单点造成的，而是 GOMAXPROCS、GOMEMLIMIT、DNS 解析方式、二进制链接模式这四者组合失效的结果。调一个参数可能掩盖问题，但换一台宿主机或升级 Docker 版本后又复现。
