sync.Cond 必须与已初始化的锁配合使用,不能独立存在;Wait() 需置于 for 循环中以防虚假唤醒和竞争;Signal/Broadcast 调用无需持锁但须确保状态已更新。
sync.cond 不能脱离锁独立存在,直接 new 出来就调用 wait() 必然 panic;它不是替代 sync.mutex 的工具,而是给已有锁加“条件等待”能力的扩展。
为什么 sync.NewCond(nil) 合法但 Wait() 会 panic
因为 sync.NewCond 只检查参数是否为 nil 接口,不校验底层锁是否初始化;而 Wait() 内部会尝试读写锁的 state 字段——对 nil 指针操作触发 runtime.throw。错误堆栈里通常出现 sync.(*Cond).Wait 和 runtime.throw。
常见误写:
cond := sync.NewCond(nil) // 看似没报错 cond.Wait() // panic: sync: Cond.Wait with uninitialized mutex
正确做法必须传入已声明、非 nil 的锁实例:
-
var mu sync.Mutex,然后cond := sync.NewCond(μ) - 若业务中用的是
sync.RWMutex,必须用同一个实例,混用sync.Mutex和sync.RWMutex会导致未定义行为 - 锁必须保护同一块共享数据——
cond的存在意义就是“等这块数据满足某状态”
Wait() 必须放在 for 循环里,不能用 if
Wait() 返回时,条件不一定成立。原因有两个:一是虚假唤醒(spurious wakeup),二是多个 goroutine 被 Broadcast() 同时唤醒后竞争锁,后拿到锁的 goroutine 可能发现条件又被改回 false。
典型错误写法:
mu.Lock()
if len(data) == 0 {
cond.Wait() // ❌ 一旦被唤醒,data 仍可能为空
}
// 后续取 data[0] → panic: index out of range
正确模式是循环检查:
mu.Lock()
for len(data) == 0 {
cond.Wait() // ✅ 自动 unlock → 等待 → 自动 re-lock
}
value := data[0]
data = data[1:]
mu.Unlock()
注意:Wait() 返回前已自动重新持有锁,无需手动 mu.Lock();也不要在 Wait() 前调用 mu.Unlock(),否则 panic。
Signal() 和 Broadcast() 的选择直接影响性能与逻辑正确性
Signal() 最多唤醒一个等待 goroutine,Broadcast() 唤醒全部——这是确定行为,不是概率事件。
选哪个,取决于你的同步语义:
- 生产者每次只放一个元素,消费者只需一个能干活的 → 用
Signal()(轻量、避免惊群) - 某个全局状态变更(如服务关闭、配置重载),所有等待者都需响应 → 用
Broadcast() - 上百 goroutine 等待时滥用
Broadcast(),会引发 CPU 尖峰和锁争用陡增
调用 Signal() 或 Broadcast() 时,**不需要持有锁**,但必须确保此时共享状态已更新完毕(比如先改 ready = true,再 cond.Signal())。顺序颠倒会导致通知丢失。
阻塞队列场景下,sync.Cond 如何配合容量控制
实现有界阻塞队列时,需两个条件变量:notFull(供生产者等待)和 notEmpty(供消费者等待),共用一把锁。
关键点:
- 入队前检查
len(queue) ,不满足则notFull.Wait() - 出队前检查
len(queue) > 0,不满足则notEmpty.Wait() - 每次入队后,要
notEmpty.Signal()(告诉消费者:有货了) - 每次出队后,要
notFull.Signal()(告诉生产者:有空位了) - 不要在
Wait()返回后直接操作数据——必须再次检查条件,因为可能被虚假唤醒或竞争抢占
最容易被忽略的是:唤醒动作本身不保证条件成立,只是“提示你该重新检查了”。这个设计让 sync.Cond 保持轻量,但也把逻辑正确性的责任完全交还给使用者。











