Go WaitGroup.Add 写在 goroutine 里为什么会偶发 Wait 提前返回

这类问题通常不是 WaitGroup 失效，而是任务计数建立得太晚。若把 wg.Add(1) 放进刚启动的 goroutine，主 goroutine 可能先执行 wg.Wait()；此时计数仍为 0，Wait 会立即返回，后续任务就脱离了这次等待。

安全规则很简单：正增量的 Add 先于创建 goroutine，Done 用 defer 对称放在任务内部，最后才调用 Wait。

为什么 Add 写进 goroutine 会让 Wait 先结束

问题代码常见于循环或批量任务：

var wg sync.WaitGroup
for _, job := range jobs {
    go func(job Job) {
        wg.Add(1) // 错误：计数建立在 goroutine 获得调度之后
        defer wg.Done() // 任务结束时归还计数
        process(job)
    }(job)
}
wg.Wait() // 可能在任何一个 Add 之前执行

启动 goroutine 只代表把函数放入可运行队列，不代表函数体已经执行。调度顺序可能是：主 goroutine 创建完第一个任务，马上执行 Wait；新 goroutine 还没运行到 Add(1)，计数器仍是 0，于是等待结束。之后那些任务才开始工作。

这也是为什么它表现为“偶发”：慢机器、日志、断点或一次调度变化都可能改变先后顺序。它不是业务任务偶尔变少，而是等待边界没有建立。

先 Add，再启动 goroutine，计数生命周期才完整

把计数动作放在创建动作之前，主 goroutine 在调用 Wait 前就已经把所有任务登记完成：

var wg sync.WaitGroup
for _, job := range jobs {
    wg.Add(1) // 先登记任务，避免 Wait 看到零计数
    go func(job Job) {
        defer wg.Done() // 无论正常返回还是提前 return 都归还计数
        process(job)
    }(job)
}
wg.Wait() // 只有所有 Done 执行后才返回

如果任务函数有多个返回分支，defer wg.Done() 应该紧跟在 goroutine 入口处。不要把 Done 放在某个成功分支，否则错误返回会让 Wait 永久阻塞；也不要复制包含 WaitGroup 的结构体。

嵌套任务和 WaitGroup.Go 怎么判断边界

这里要区分“计数器为零”和“计数器已经大于零”。如果父任务已经通过 Add(1) 建立了计数，父 goroutine 内再为子任务增加计数，时序通常是安全的，因为 Wait 不会在父任务完成前看到零：

wg.Add(1) // 先把父任务放进计数器
go func() {
    defer wg.Done() // 父任务完成后再归还
    wg.Add(1) // 此时计数器仍由父任务占用
    go func() {
        defer wg.Done() // 子任务单独归还一次
        processChild()
    }()
}()
wg.Wait()

但这种写法要明确父任务必须覆盖子任务登记的窗口，不能让父任务先 Done 再创建子任务。较新的 Go 版本还提供 WaitGroup.Go，它把启动和计数绑定在一起；使用时仍需遵守：空 WaitGroup 上的第一次 Go 必须先于 Wait，且传入函数不能 panic。

排查偶发提前返回的四项检查

1. 搜索所有 WaitGroup 的正向 Add，确认它是否位于 go func 之前。
2. 检查每个 goroutine 是否在入口处用 defer wg.Done()，包括错误、超时和提前返回路径。
3. 确认同一个 WaitGroup 没有在上一轮 Wait 返回前开启下一轮任务。
4. 若任务会动态派生，先证明父任务持有计数，再允许子任务追加；否则改用显式任务队列或把任务列表先收集完整。

修复后不要靠增加 Sleep 验证。睡眠只能改变调度概率，不能建立同步关系；真正的修复是让计数先于等待边界可见。

常见问题

只启动一个 goroutine，Add 放里面也一定有问题吗？

有问题。即使当前运行经常先执行 goroutine，也没有顺序保证；代码一旦换机器、加日志或增加负载就可能暴露。

Done 能不能在 goroutine 外调用？

可以由其他协作逻辑调用，但必须保证每次 Add 都恰好对应一次 Done。通常把 Done 放在任务函数入口的 defer 中更不容易漏。

WaitGroup 能不能跨批次复用？

可以，但新一轮正向 Add 必须等上一轮 Wait 返回；不要让两轮任务共享同一个零计数窗口。