17370845950

当 go 单元测试因死锁卡住时，直接按 ctrl+c 无法捕获 `t.log()` 输出；使用 ctrl+\ 可触发运行时栈回溯，辅助定位阻塞点，但需配合 `-v` 标志和合理日志策略才能完整获取调试信息。

在 Go 中运行单元测试（如 go test -run TestFoo）时，若测试逻辑存在 goroutine 死锁、channel 阻塞或无限等待，进程会挂起。此时用户常试图用 Ctrl+C 终止，但该信号会强制退出 go test 进程，导致尚未 flush 的 t.Log() 日志（尤其是缓冲中未输出的内容）丢失，无法用于诊断。

✅ 正确做法是：在测试卡住时按下 Ctrl+\（即 Control + Backslash）。
该组合键向当前进程发送 SIGQUIT 信号（而非 SIGINT），Go 运行时会响应此信号并：

• 立即打印所有 goroutine 的完整调用栈（包括阻塞位置，如 select {}、chan receive、sync.Mutex.Lock 等）；
• 不终止进程，而是暂停执行并输出诊断信息后保持挂起状态（便于观察）；
• 关键点：t.Log() 的输出本身不会自动出现在 SIGQUIT 输出中，但只要测试启动时加了 -v 标志（即 go test -v），所有 t.Log() 消息会在测试执行过程中实时打印到终端——因此务必始终启用 -v 进行调试。

? 示例：

go test -v -run TestDeadlock

func TestDeadlock(t *testing.T) {
    t.Log("step 1: starting...")
    ch := make(chan int)
    t.Log("step 2: about to block on channel receive")
    <-ch // ← 死锁在此处发生
}

当执行卡在

SIGQUIT: quit
PC=0x109a7a1 m=0 sigcode=0

goroutine 19 [chan receive]:
command-line-arguments.TestDeadlock(0xc0000b40f0)
    /path/to/test.go:8 +0x71
...

⚠️ 注意事项：

• Ctrl+\ 在部分终端（如 Windows PowerShell 或某些 IDE 内置终端）可能被拦截或无效，推荐在标准终端（macOS Terminal、Linux GNOME Terminal、Windows WSL）中使用；
• 若仍看不到 t.Log() 内容，请确认未使用 -short 或重定向覆盖了 stdout/stderr；
• 对于长期阻塞场景，可结合 runtime.SetBlockProfileRate(1) 和 pprof 进一步分析阻塞事件；
• 更健壮的调试方式：为关键路径添加带时间戳的 t.Logf("at %v: waiting for X", time.Now())，并设置测试超时：go test -v -timeout 10s。

总结：Ctrl+\ 是 Go 测试死锁诊断的“紧急刹车”，配合 -v 和显式日志，能高效定位 hang 点；而预防胜于调试——建议在并发测试中始终使用 t.Parallel() 显式声明、避免共享未同步状态，并善用 select 带 default 或 time.After 实现超时保护。