sync.Cond不能复制,因内部copyChecker字段在每次方法调用前检测其地址是否被篡改:复制后该字段值(旧地址)与当前&checker真实地址不等,即panic;noCopy仅防静态赋值,copyChecker则拦截运行时所有复制路径。

sync.Cond 不能复制,一旦复制就会 panic,这是运行时强制保障的,不是文档警告或 vet 提示——它由 copyChecker 在每次调用 Wait、Signal、Broadcast 前实时检测。
copyChecker 是怎么发现被复制的?
它本质是一个 uintptr 字段,初始化时存入自身地址;后续每次调用 check() 都会对比:当前字段值是否还等于它在内存中的真实地址。不等就 panic。
这个判断逻辑看似复杂,实际只做三件事:
- 如果字段还是初始零值(
0),就把它设为&checker的地址,并返回 - 否则,检查
*c == uintptr(unsafe.Pointer(c))是否成立 - 如果不成立,再尝试用
atomic.CompareAndSwapUintptr抢占式写入一次(防多 goroutine 竞态初始化),失败后仍不等,就 panic
关键点在于:结构体复制会把整个 checker 字段的值(即旧地址)一起拷贝过去,但新副本里 &checker 的地址已经变了——这就构成了可检测的不一致。
为什么 noCopy 字段还不够?
noCopy 只能防编译期浅拷贝(比如赋值语句),靠 go vet -copylocks 静态扫描发现;但它拦不住运行时通过 unsafe、reflect 或结构体字节拷贝绕过的深复制。
copyChecker 是第二道防线,且是动态的、每次方法调用都触发的。两者配合才真正封死所有复制路径:
-
noCopy拦住常见误用(如c2 := c1) -
copyChecker拦住反射拷贝、unsafe.Copy、序列化反序列化后的重建等隐蔽场景
这也是为什么官方文档强调 “Cond must not be copied after first use”——“first use” 指的是第一次调用任何方法,因为那是 check() 首次生效的时刻。
容易踩的坑:指针传参和字段嵌入
最常误踩的不是主动复制,而是无意中触发了值传递:
- 把
*sync.Cond当作普通指针传给函数,但函数签名写成func f(c sync.Cond)(少了个*),导致传入的是值拷贝 - 把
sync.Cond嵌入自定义结构体,且该结构体被复制(哪怕只是作为 map value 或 channel 元素发送),也会连带复制checker - 用
json.Unmarshal或gob.Decode到一个含sync.Cond字段的 struct,会覆盖原字段值,破坏地址一致性
正确做法永远只传递 *sync.Cond,且绝不在结构体中直接嵌入 sync.Cond;如需组合,应嵌入 *sync.Cond 或通过字段访问器封装。
为什么不能用 atomic.Value 包一层来“安全复制”?
有人想绕过限制,把 sync.Cond 放进 atomic.Value 再 Load/Store——这依然不行。因为 atomic.Value 的 Store 会复制其参数值,而 sync.Cond 的复制检测发生在方法调用时,不是构造时。
更关键的是:atomic.Value 存的是 sync.Cond 值本身(非指针),只要一 Store,内部 checker 就已失配;后续任何 Load().Signal() 都会 panic。
真正安全的“共享”方式只有一种:全局单例或长期存活的指针变量,所有代码共用同一个 *sync.Cond 实例。

















