当 go 程序因死锁、竞态或调度阻塞而无响应时，可通过发送 sigquit 信号触发运行时打印完整 goroutine 堆栈，无需修改代码即可快速定位卡死位置。
当 go 程序因死锁、竞态或调度阻塞而无响应时，可通过发送 sigquit 信号触发运行时打印完整 goroutine 堆栈，无需修改代码即可快速定位卡死位置。
Go 运行时内置了对诊断信号的原生支持，其中 SIGQUIT（通常由 kill -QUIT <pid> 或 Ctrl+\ 触发）是最直接有效的调试手段：它不会终止程序逻辑（除非进程已处于不可恢复状态），而是立即暂停所有 goroutine，并将每个活跃 goroutine 的完整调用栈、当前状态（running、waiting、syscall 等）、G/M/P 调度信息以及锁持有情况输出到标准错误（stderr）。这对于排查“程序完全挂起但无 panic 日志”的典型问题（如隐式死锁、channel 阻塞、sync.Mutex 未释放）极为关键。
使用方式如下：
# 启动你的 Go 服务（确保 stderr 可见或重定向到日志文件） ./my-server # 在另一终端中，查找进程 PID ps aux | grep my-server # 发送 SIGQUIT —— 注意：不是 SIGKILL 或 SIGTERM kill -QUIT <pid> # 或在前台运行时直接按 Ctrl+\（反斜杠）
输出示例节选：
SIGQUIT: quit
PC=0x105e720 m=0 sigcode=0
goroutine 0 [idle]:
runtime.futex(0x1c8d4b0, 0x0, 0x0, 0x0, 0x0, 0x1c8d4b0, 0x0, 0x0, 0x7ffeefbff698, 0x105a93f, ...)
/usr/local/go/src/runtime/sys_darwin.go:391 +0x1f
goroutine 1 [semacquire]:
sync.runtime_Semacquire(0xc00001a0a8)
/usr/local/go/src/runtime/sema.go:56 +0x45
sync.(*Mutex).lockSlow(0xc00001a0a0)
/usr/local/go/src/sync/mutex.go:142 +0x12a
...⚠️ 注意事项：
- SIGQUIT 默认会退出进程（exit status 2），若需保留进程继续运行以便多次采样，可结合 GOTRACEBACK=all 环境变量增强输出，并在程序中捕获 os.Interrupt 或自定义信号处理器（但不推荐覆盖默认 SIGQUIT 行为，因其是 Go 官方支持的调试契约）；
- 对于生产环境，建议启用 GODEBUG=schedtrace=1000,scheddetail=1（每秒打印调度器快照）辅助长期观测，但注意性能开销；
- 若程序已完全僵死（如陷入内核态无限等待），SIGQUIT 可能无法响应——此时需配合 gdb 或 pprof 的 runtime/pprof.Lookup("goroutine").WriteTo(os.Stdout, 1) 主动导出（需提前嵌入健康端点）；
- 竞态检测应优先使用 go run -race 或 go build -race 编译，它能在运行时动态报告数据竞争，比事后分析堆栈更精准。
总之，SIGQUIT 是 Go 开发者必须掌握的“急救指令”——它不依赖日志埋点、无需重启服务，一次信号即可暴露所有 goroutine 的实时状态，是诊断 hang 问题最轻量、最权威的第一响应工具。
