Go 1.22 把 WaitGroup.Add 挪进 goroutine 后直接报负计数崩了

服务日志里突然出现 paniC: SYNc: negative WaitGroup counter,进程直接退出,前几秒还在正常处理任务。复现概率很低,十几分钟一次,本地压测两个多小时才撞上一回,抓到栈的时候 goroutine 号早就换了。

先数是和 Done 配对,全局搜 wg.Done 有 4 处,wg.Add 只有 2 处,其中一处还写在 goroutine 里面。把 Add 挪到 go 之前,panic 频率降下来但没绝迹,说明不止这一个原因。

用 -race 跑了 200 轮,报的是同一个计数器被两个 goroutine 同时改。真正的问题是有个分支提前 return,defer 已经登记过 Done,外层兜底逻辑又补了一次,计数从 1 减到 0 再减成 -1,panic 就这么来的。

还有个更隐蔽的写法,wg 是包级变量,上一批任务没 Wait 完就被复用,新的 Add 落在旧的计数上,表现同样是负数。这种只能靠每次任务新建一个 WaitGroup 解决,复用计数器等于自己给自己埋雷。

Go 1.22 改了循环变量语义,闭包里传参那一步可以省,但它和 WaitGroup 的计数没有半点关系,别指望升个版本能把这类 bug 盖住。

确认口径:-race 连跑 500 轮无输出;压测 6 小时 panic 计数 0;把提前 return 的分支单独造数据打 1000 次,Done 的调用次数与 Add 严格相等。

var wg sync.WaitGroup
for _, p := range files {
    wg.Add(1)
    go func(name string) {
        defer wg.Done()
        if !handle(name) {
            return
        }
        index(name)
    }(p)
}
wg.Wait()

您可以还会对下面的文章感兴趣: