Go 并发治理上线清单：从代码到压测的 20 个检查点

并发治理最终要落到上线流程里。清单的价值，是把容易遗漏的细节变成发布前固定动作，避免每次都靠经验临场发挥。

代码检查

入口是否创建 timeout context，下游是否全部接收 context，是否存在 context.Background 混入请求链路，goroutine 是否有退出条件，channel 是否有容量和关闭协议。

容量检查

限流阈值、worker 数、批量大小、HTTP 连接池、数据库连接池都要能解释来源，并且和下游容量匹配。

压测检查

压测不只看峰值 QPS，还要观察排队、超时、降级、重试、DBStats 和 goroutine 是否回落。压测结束后资源不能持续高位。

生产场景

适用于专题前面所有策略的上线前复核。清单不是文档摆设，而是发布前必须逐项勾选的工程流程。

关键指标

• 压测结束后 goroutine、连接池和队列回落时间
• 上线后一小时内 5xx、429、timeout、fallback 变化
• 发布、回滚和优雅停机演练结果

常见误区

• 只做代码 review，不做容量验证
• 压测只打正常流量，不模拟下游慢和错误
• 监控未上线就发布治理逻辑

落地建议

建议把清单固化到发布模板：每次变更都填写限流值来源、连接池预算、超时链路、降级策略、压测结论和回滚方法。缺少任一项都不应直接上生产。

上线检查

• 入口超时和下游超时一致。
• 所有重试都有退避和幂等保护。
• 限流、降级、队列满都有指标。
• pprof 和日志能定位 goroutine 堆积。
• 发布演练验证优雅停机。