死锁发生时程序立即 panic，需通过堆栈定位阻塞的 channel 或锁；Go 无运行时死锁检测 API，所谓检测实为捕获 panic 并分析线索。
Go 程序一旦触发 fatal error: all goroutines are asleep - deadlock!，说明死锁已发生且不可恢复——此时不是“检测是否会有死锁”，而是“必须立刻看 panic 堆栈定位哪条 channel 或哪把锁卡住了”。
死锁 panic 就是最终检测结果，别绕开它写检测函数
Go 运行时没有 runtime.IsDeadlocked() 这类 API。所谓“实现死锁检测”，本质是接受 panic 并从中提取线索，而不是在代码里加逻辑去预测。运行时发现所有 goroutine 全部阻塞在：ch 、<code>、<code>mu.Lock()、wg.Wait() 或 select {} 上，且无人能唤醒时，会立即终止并打印堆栈。
常见误操作：
- 在 main 末尾加
time.Sleep(5 * time.Second)等 goroutine 完成——这会让主 goroutine 卡住，但只要还有任意一个 goroutine 处于 runnable 状态，运行时就不会报死锁，反而掩盖问题 - 试图用
runtime.NumGoroutine()判断是否“只剩 1 个”来推测死锁——数量不等于状态，goroutine 可能早已阻塞但未被调度器标记为 asleep - 把
sync.WaitGroup当值传递进 goroutine，导致wg.Done()操作在副本上执行，主 goroutine 永远等不到wg.Wait()返回
/debug/pprof/block 是死锁发生前最准的现场快照
当程序“变慢”“没响应”但还没 panic，/debug/pprof/block 能暴露真实阻塞点。它只显示因同步原语（channel、mutex、semaphore）而阻塞的调用链，含等待时长和 goroutine ID。
立即学习“go语言免费学习笔记（深入）”；
启用方式（无需修改业务逻辑）：
- 启动时导入：
import _ "net/http/pprof" - 启动 HTTP 服务：
http.ListenAndServe(":8080", nil) - 访问：
http://localhost:8080/debug/pprof/block
关键观察点：
- 某
ch 操作等待超 3 秒，基本可确认接收端缺失、未启动或已退出 - 多个 goroutine 都停在同一个
mu.Lock()调用，且无对应mu.Unlock()堆栈，大概率是锁未释放或重复加锁 - 页面默认只监听
localhost，生产环境若需使用，必须显式绑定到内网地址（如:8080）并配合反向代理鉴权，切勿暴露公网
go run -race 不查死锁，但能揪出“假死锁”的真因
很多表面死锁，实际是竞态导致的逻辑断链：比如两个 goroutine 同时改共享 map，其中一个覆盖了信号字段，另一个永远收不到通知，于是卡在 ——这不是死锁，是数据错乱。
go run -race main.go 必须作为日常开发环节，尤其注意这些高危模式：
- HTTP handler 中复用 struct 实例并修改其字段（如存
req.Context().Value()），多个请求并发访问就会 race - 闭包捕获循环变量：
for _, h := range handlers { go func() { h.ServeHTTP() }() }→ 所有 goroutine 共享最后一个h，修复为go func(h Handler) { h.ServeHTTP() }(h) - 全局配置 map 在
init()初始化后，又被某个 goroutine 动态更新且未加锁
条件编译不是用来“开关死锁检测”的
Go 没有类似 #ifdef DEBUG_DEADLOCK 的机制，也不该有。死锁不是调试期才存在的问题，它在 prod 同样致命。所谓“条件编译”真正该干的事只有两件：
- 仅在开发环境启用 pprof：用
//go:build debug+build tags控制_ "net/http/pprof"是否导入 - 用
build tags区分是否带-race构建（例如//go:build race），但测试阶段必须跑，不能只在 CI 里开
别试图用 build tag 去“屏蔽死锁 panic”或“替换 channel 实现”——那只会让问题更难复现。真正的诊断依赖的是 panic 日志第一行的错误类型，和后续每一行 goroutine 的阻塞位置。复杂点在于：你得同时看懂 channel 收发节奏、锁持有范围、WaitGroup 计数匹配，以及 context 是否被正确传递。漏掉任一环，堆栈就只是噪音。
