这两年我看 Go 服务的线上问题，有一类特别容易被误判：CPU 看着没打满，接口 P99 却突然变难看；容器明明只给了 500m 或 1 核，进程里却像拿着整台宿主机的 CPU 数在调度。以前我会让团队引入 automaxprocs，现在 Go 1.25 把这件事往 runtime 里收了，这个变化值得单独写一篇。
这篇不当发布说明翻译。我按真实排查顺序来讲：先说 GOMAXPROCS 到底影响什么，再说它为什么会被 Kubernetes 的 CPU limit 坑到，最后给一套上线前可以照着跑的验证清单。
先把概念说人话：GOMAXPROCS 不是 goroutine 数量
很多初学者会把 GOMAXPROCS 理解成“最多开几个 goroutine”，这不准确。它限制的是同一时刻能并行执行 Go 用户代码的 P 数量。goroutine 可以很多，但真正同时跑用户代码的上限会被 GOMAXPROCS 卡住。
在裸机时代，这个默认值等于机器逻辑 CPU 数，问题不大。但容器时代不一样：你的 Pod 可能只给了 500m CPU limit，却跑在 64 核节点上。老版本 Go 如果只看宿主机 CPU，就容易让 runtime 以为自己有很多并行额度，结果被 CFS throttling 按在地上摩擦，P99 延迟就会抖。
Go 1.25 变了什么
Go 1.25 在 Linux 上会参考当前进程所在 cgroup 的 CPU bandwidth limit。简单说，如果容器 CPU limit 比机器逻辑 CPU 更低，默认 GOMAXPROCS 会倾向于取更符合容器配额的值。官方文档也特别提醒：这里看的是 CPU limit，不是 Kubernetes 的 CPU request。
还有一个容易被忽略的点：Go 1.25 会周期性更新默认 GOMAXPROCS。如果容器运行时调整了 CPU limit，runtime 有机会跟着更新。这对平台侧动态调度更友好，但对应用侧也意味着你不要在业务里假设这个值永远不变。
我会怎么在 K8s 里验证
第一步，给测试 Pod 明确设置 CPU limit，比如 500m 或 1000m。第二步，在容器内打印 runtime.GOMAXPROCS(0)。第三步，观察 /sys/fs/cgroup/cpu.stat 里的 throttling 指标，再看压测时的 P95/P99。
这里最忌讳的是只看平均延迟。CPU throttling 很多时候不会把平均值拉得特别夸张，但会让尾部延迟变难看。线上服务真正影响用户体验的，往往就是这些长尾请求。
手动设置过 GOMAXPROCS 的项目要小心
如果你设置了环境变量 GOMAXPROCS，或者代码里主动调用了 runtime.GOMAXPROCS(n)，Go 1.25 的自动行为会被关闭。这个设计是合理的：你既然手动指定了，runtime 就不应该擅自改。
所以迁移时我会先全局搜一遍：Dockerfile、Helm values、启动脚本、main 函数、老的性能优化包。尤其是以前引入过 go.uber.org/automaxprocs 的项目，要明确决定是继续保留，还是在升级 Go 1.25 后逐步移除，别让两个机制一起影响判断。
一段最小检查代码
package main
import (
"fmt"
"runtime"
)
func main() {
fmt.Println("GOMAXPROCS:", runtime.GOMAXPROCS(0))
fmt.Println("NumCPU:", runtime.NumCPU())
}
这段代码没什么技术含量，但上线前很有用。把它放到同样的镜像、同样的资源限制里跑一下，比在会议里争论“理论上应该是多少”靠谱多了。
生产落地清单
- 确认服务已经使用 Go 1.25 或更新版本构建。
- 确认 Pod 设置的是 CPU limit，而不是只设置 request。
- 检查是否存在手动
GOMAXPROCS环境变量或代码调用。 - 压测时同时看吞吐、P99、CPU throttling、GC 暂停和 goroutine 数。
- 如果移除 automaxprocs，要灰度发布，不要一次全量替换。
我的建议
Go 1.25 这个改动不是让你从此不用懂 GOMAXPROCS，而是把默认值变得更贴近容器现实。对大多数 K8s 服务，这是好事；但只要你的服务对延迟很敏感，或者 CPU limit 设置得很紧，就应该认真验证，而不是升级完直接宣布性能问题自动消失。
我自己的习惯是：升级 runtime 只算第一步，真正能让我放心的是一组对比数据。旧版本、新版本、是否手动设置 GOMAXPROCS、不同 CPU limit 下的 P99 和 throttling，都跑一遍，答案自然会出来。
参考资料：Go 1.25 Release Notes、Go Blog《Container-aware GOMAXPROCS》。
Go JSON v2 实战：别急着替换 encoding/json，先搞懂这些变化 
