Go test -race 未报竞态的根本原因是测试未真正并发执行，如漏调 wg.Add()、未等待 goroutine 结束、值传递导致 mutex 失效、锁粒度不足或漏锁等。
Go test -race 为什么没报竞态？
根本原因通常是测试没真正并发执行——比如用了 sync.WaitGroup 但忘记 wg.Add()，或 goroutine 启动后立刻 wg.Wait() 却没等完就退出。更隐蔽的是：测试函数本身是串行的，只在内部调用了一个并发函数，但没让主 goroutine 等待它结束。
- 必须确保所有 goroutine 都有机会运行并交叉访问共享变量，
-race才能观测到冲突 - 测试里启动 goroutine 后，别用
time.Sleep()等待，优先用sync.WaitGroup或chan同步 - 如果被测代码依赖外部信号（如 HTTP 请求、定时器），测试中要 mock 或缩短超时，否则
-race可能因超时提前退出而漏检
struct 字段被 race 报告，但加了 mutex 还是报？
常见于锁粒度不对或漏锁：mutex 没覆盖全部读写路径，或者用了值拷贝导致锁失效。Go 中 sync.Mutex 不可复制，但 struct 赋值、函数传参若用值传递，会复制整个 struct，连带复制一个“新”的 mutex，原锁完全失效。
- struct 字段访问前，必须确保同一把
mu已Lock()/Unlock() - 避免对含
sync.Mutex的 struct 做值传递；函数参数、返回值、map value 都该用指针*MyStruct - 检查是否在 defer 中 unlock，但 lock 在 if 分支里——可能根本没 lock 就 unlock，或反过来漏 unlock
race detector 报告 “Previous write at …” 但找不到对应代码行
说明写操作发生在其他 goroutine，且该 goroutine 可能已退出，而 race detector 仍保留其内存访问记录。典型场景是：goroutine 写完变量后立即退出，主线程稍后读取，此时 race detector 会把“上一次写”定位到那个已结束的 goroutine 的最后一行（常是 return 或函数末尾）。
- 重点查报告中 “Previous write” 和 “Current read” 的 goroutine ID 是否不同；相同 ID 一般是逻辑顺序问题，不同 ID 才是典型并发问题
- 注意日志里带
created by的行——它指出该 goroutine 是在哪一行启动的，比 “Previous write” 行更有定位价值 - 如果写操作在第三方库中（如
http.ServeMux内部），race 报告可能指向库源码；这时要确认你是否意外共享了本该独享的实例（如全局http.DefaultServeMux）
CI 里跑 -race 很慢还偶尔失败，能关掉吗？
不能关，但可以优化。-race 会让程序运行变慢 2–5 倍，内存占用翻倍，且对调度敏感——某些竞态只在特定时间窗口触发，CI 资源紧张时更容易漏掉。
立即学习“go语言免费学习笔记（深入）”；
- 仅对核心模块开启：
go test -race ./pkg/... -run=^TestCriticalFlow$，避免全量跑 - 禁止在 race 模式下使用
GOMAXPROCS=1：它会抑制调度切换，反而让竞态更难暴露 - CI 中若出现 “signal: killed” 或 OOM，不是 race 本身问题，而是资源不足；应限制并发数（
-p=2）或升级机器内存
真正麻烦的不是报错多，而是不报错——因为没跑起来、没并发起来、或者锁用错了位置。race detector 不是银弹，它只告诉你“这里发生了”，不解释“为什么发生”。得盯着 goroutine 生命周期和锁作用域看。
