不能直接用 runtime.NumGoroutine() 做线上实时预警，因其仅返回瞬时总数，缺乏基线、无法区分合法波动且无上下文，盲目设阈值会导致99%误报；应基于可控上下文做滑动窗口差值监控，如 HTTP handler 入口与 defer 中采样 delta，并结合 P95 与连续异常判断真实泄漏。
不能直接用 runtime.NumGoroutine() 做线上实时预警，它只返回瞬时总数，没有基线、不区分合法波动、也不带上下文——盲目设阈值（比如 >100 就告警）99% 是误报。
为什么直接监控绝对值会频繁误报
Go 运行时自身就维持一批动态 goroutine：GC worker、timer goroutine、netpoller 线程绑定 goroutine、pprof HTTP server 监听器……它们随负载起伏，刚启动时从 5 跳到 70+ 很正常。HTTP server 的长连接、redis client 的心跳协程、logrus 的异步 flush 协程，只要数量稳定就不算泄漏。
- 单次请求后
runtime.NumGoroutine()比入口高 3～5 个？大概率是临时 handler goroutine 还没调度完，或 defer 中的 cleanup 尚未执行 - 压测中数值翻倍？只要压测结束 30 秒后回落到空闲态附近，就是健康行为
- 把
runtime.NumGoroutine()当 Prometheus 指标暴露，却没做滑动窗口差值计算，图表上全是毛刺，根本看不出真实趋势
线上可用的轻量级差值监控方案
核心不是“现在有多少”，而是“比上一次同场景多了多少”。需在可控上下文里做前后采样，且排除系统抖动。
- 对每个 HTTP handler，在入口打点：
before := runtime.NumGoroutine()；在 defer 里等 100ms 后再采一次：after := runtime.NumGoroutine()；记录 delta = after - before - 用滑动窗口（如最近 100 次请求）统计 delta 的 P95，若连续 5 次超过 P95 + 2，则触发告警——这能过滤掉偶发的 timer/GC 波动
- 避免在中间件里全局采样：不同 handler 生命周期差异大，混在一起会掩盖特定路径的泄漏（比如 /health 永远 delta=0，/upload 却持续 +3）
- 别依赖
time.Sleep等待：某些 goroutine 依赖外部信号（如 channel 关闭、context cancel），应配合select { case 或 <code>time.AfterFunc显式等待退出完成
pprof 快照自动比对才是真预警源头
runtime.NumGoroutine() 只负责“拉响警报”，真正定位泄漏必须靠 pprof 堆栈对比。线上不能人工 curl，得自动化。
立即学习“go语言免费学习笔记（深入）”；
- 每 5 分钟自动抓一次
/debug/pprof/goroutine?debug=2快照，保存为 timestamp.txt - 用脚本 diff 最新快照和 1 小时前的 baseline，提取新增且状态为
chan receive、select或semacquire的 goroutine 堆栈 - 若同一堆栈在连续 3 个快照中都出现，且阻塞时长 > 300s，直接推送告警并附上完整调用链——这比数字涨了 10 个可靠得多
- 注意：
?debug=1只给摘要，必须用?debug=2才能看到 sender/receiver 信息和精确阻塞时间，否则无法判断是“暂时等待”还是“永久卡死”
真正难的不是采集数字，而是定义“同场景”——handler 入口采样看似简单，但若该 handler 内部调用了未 mock 的第三方 client（如 go-redis），它的后台重连 goroutine 也会被计入 delta。这类干扰项必须提前用 goleak 规则过滤，否则预警永远在修假 bug。
