Golang信号处理Signal全面解析

本文深入解析了 Go 语言中信号处理的核心机制与常见陷阱：默认情况下，Go 程序对 SIGINT 和 SIGTERM 等关键信号不做任何响应，进程会立即终止，导致资源清理、优雅关闭等关键逻辑完全失效；而使用 signal.Notify 时若未为接收 channel 设置缓冲，由于其非阻塞、不排队、不重试的特性，极易丢失首个（甚至多个）信号，造成程序无法及时响应中断——这些看似细微的细节，实则是构建健壮、可运维 Go 服务的关键防线。

Go 程序不主动注册信号监听，SIGINT 和 SIGTERM 会直接终止进程，清理逻辑根本没机会执行。

signal.Notify 必须配带缓冲 channel，否则第一次信号就丢

signal.Notify 只是把信号往 channel 里发，它不阻塞、不排队、不重试。如果 channel 没缓冲，且主 goroutine 还没来得及 ，信号就来了——这个信号会被直接丢弃，后续也收不到。

• 必须用 make(chan os.Signal, 1) 或更大缓冲；make(chan os.Signal)（无缓冲）是常见错误源头
• 连续发两次 SIGTERM，缓冲为 1 的 channel 只能存一个，第二个信号丢失——别依赖“多发几次保险”
• 别在 signal.Notify 后立刻 select 等信号，除非你确保没有其他逻辑抢先跑完并退出 main
• 容器或 systemd 环境下，信号可能压根没传进来，先用 strace -e trace=rt_sigaction,kill 验证信号是否抵达进程

收到信号后不能直接 os.Exit，必须让主 goroutine 控制退出节奏

在 goroutine 里调 os.Exit() 看似简单，实际跳过所有 defer、HTTP server 关闭、DB 连接释放，还可能卡死在 cleanup 阻塞操作里。

• 正确做法：用 select 在主 goroutine 中等待信号，收到后执行清理，再 os.Exit(code)
• 退出码要映射 POSIX 规则？用 map[syscall.Signal]int{syscall.SIGINT: 130, syscall.SIGTERM: 143}
• 别用 log.Fatal() 替代——它固定退出码 1，且绕过 defer
• 如果清理耗时不可控（比如 DB 连接池归还慢），必须套 context.WithTimeout，超时后强制 os.Exit()

http.Server.Shutdown 超时 ≠ 信号没收到，而是 handler 卡住了

Shutdown 返回超时，95% 的情况不是信号问题，而是你的 HTTP handler 没响应 context 取消，还在等数据库、RPC 或未关闭的流式响应。

• 每个 handler 必须接收 http.Request.Context()，所有 I/O（db.QueryContext、http.Client.Do）都要带这个 ctx
• srv.Shutdown(ctx) 的 ctx 是“最多等多久”，不是“强制杀掉 handler”；真正中断靠 handler 内部检查 ctx.Done()
• 漏掉 defer resp.Body.Close() 会导致连接不释放，Shutdown 一直等它
• 长轮询、SSE、WebSocket 场景下，超时建议设 10–30 秒，太短等于放弃优雅

goroutine 泄漏会让程序“假退出”——进程还在，但信号处理已失效

现象是：按了 Ctrl+C，日志打出 “shutting down”，但进程 ps 还在，或者报 panic: send on closed channel。本质是还有 goroutine 在往已关闭的 channel 发数据，或没监听 ctx.Done() 就自己卡死了。

• 所有后台 goroutine（ticker、worker、轮询）开头必须加 select { case
• 用 sync.WaitGroup 记录活跃 worker，cancel() 后调 wg.Wait()，但别只靠它——它不解决“不退出”的 goroutine
• 避免在 shutdown 阶段启动新 goroutine（比如异步上报），除非你用独立 ctx + timeout 显式控制它生命周期
• docker 的 terminationGracePeriodSeconds 或 systemd 的 TimeoutStopSec 要大于你的最大 Shutdown 耗时，否则系统会补发 SIGKILL

信号处理最难的不是写那几行 signal.Notify，而是每个资源打开、每个 goroutine 启动、每个外部调用，都得预设“它怎么被叫停”。漏掉一个，整个优雅退出链就断了。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Golang信号处理Signal全面解析》文章吧，也可关注golang学习网公众号了解相关技术文章。