sync.Cond 必须与锁配合使用,传入锁的指针(如 &sync.Mutex{}),Wait 前需已持锁;条件检查必须用 for 循环,先修改状态再 Signal/Broadcast,且变量读写须受同一锁保护。

sync.Cond 必须和锁一起用,不能单独创建
直接传一个未加锁的 sync.Mutex{} 给 sync.NewCond 不会编译报错,但后续 Wait 行为完全不可预测——可能永远不唤醒、可能 panic、也可能触发 data race。正确做法是传入锁的地址,并确保调用 Wait 前已持有该锁。
- 必须用指针:传
&sync.Mutex{},不是sync.Mutex{} - 读写锁也一样:
sync.NewCond(&sync.RWMutex{})合法,但调用Wait前必须用Lock()(不是RUnlock()) - 锁对象生命周期要长于
Cond:别在函数里临时声明锁再传给NewCond,容易被 GC 提前回收
Wait 必须写在 for 循环里,不能用 if
Cond.Wait 可能被虚假唤醒(spurious wakeup),也可能在条件真正就绪前返回。一旦用 if !done { cond.Wait() },唤醒后直接往下走,大概率读到旧值或空状态。
- 正确模式:
for !done { cond.Wait() },每次唤醒都重新检查 - 条件检查必须是轻量、无副作用的:比如读原子变量
atomic.LoadUint32(&state)、查切片长度len(queue) > 0、比对布尔标志位 - 避免在循环体里修改共享状态——那该放在
Signal或Broadcast前统一做
Signal 和 Broadcast 不是“发消息”,而是“通知检查”
Signal 和 Broadcast 本身不校验条件是否真满足,只是把等待的 goroutine 唤醒,让它们回去重新跑一遍 for 循环里的条件判断。所以顺序必须是:先改状态,再通知。
- 错误写法:
cond.Signal(); done = true→ 唤醒时done还是false,等待者又进循环 - 正确写法:
done = true; cond.Signal(),且这整段必须在锁保护下完成 - 高频事件慎用
Broadcast:几百个 goroutine 同时被唤醒、抢锁、检查条件、发现不满足再挂起——调度开销陡增,还可能引发惊群效应
任务调度中 Cond 的典型误用场景
很多人想用 sync.Cond 替代 channel 做任务分发,结果掉坑里。它不适合「一对多分发任务」,只适合「多对一等待状态变更」。
- 适合:
Push完成后通知所有Consumer可以开始处理(状态变更);服务关闭时广播停止信号 - 不适合:从一个队列里取任务分给多个 worker(该用
chan+select) - 混合使用更稳妥:用 channel 传任务数据,用
Cond控制启动/暂停/重载等全局状态
done、queueLen、isReady),而且这个变量的读写必须受同一把锁保护——漏掉这点,-race 会立刻报出来。


















