Golang服务优雅关机失效：重新部署后未触发信号问题排查

代码中的明显错误 #

你在goroutine里主动调用syscall.Kill(syscall.Getpid(), syscall.SIGTERM)完全是多余且错误的——这会导致服务刚启动就给自己发终止信号，直接触发关机流程，和你“仅在重新部署时触发优雅关机”的需求完全矛盾，且会干扰正常的信号处理逻辑，必须删掉这一行。

重新部署时quit通道未收到信号的核心原因 #

1. 部署系统发送的信号无法被捕获或未注册

• 如果部署系统超时后发送SIGKILL，这个信号是操作系统强制杀死进程的信号，任何程序都无法捕获或处理，优雅关机必然无法触发。
• 如果部署系统发送的信号不在你注册的列表中（比如部分系统用SIGUSR1/SIGUSR2触发重启），quit通道也不会收到通知。
• 修复：确认部署系统的终止信号类型（比如Kubernetes默认先发SIGTERM，等待超时后发SIGKILL），确保SIGTERM/SIGINT这类可捕获信号在signal.Notify的注册列表中；同时调整部署配置，给服务足够的优雅关机时间，避免直接发送SIGKILL。

2. 信号处理逻辑被覆盖或重置

如果程序其他地方有调用signal.Notify将相同信号注册到其他通道，或者调用signal.Reset重置了信号处理规则，会导致当前的quit通道无法收到信号。

• 修复：排查代码中所有信号处理相关逻辑，确保没有覆盖当前的signal.Notify配置。

3. 进程未正确接收部署系统的信号

如果服务以子进程方式运行（比如容器中用shell启动），部署系统发送的信号会被shell父进程接收，而非你的Go服务进程，导致服务收不到信号。

• 修复：确保Go服务是容器/进程组的PID 1进程，比如Dockerfile中使用CMD ["./your-service"]（而非CMD "./your-service"），直接用exec模式启动服务。

4. 关机超时导致被强制杀死

你的代码设置了5秒的关机超时，如果5秒内未完成所有活跃连接的关闭，server.Shutdown会返回错误，此时进程可能还未完全退出，部署系统会发送SIGKILL强制终止，让你误以为quit通道没收到信号。

• 修复：根据业务实际调整超时时间（比如改为10秒），同时在日志中增加server.Shutdown的开始/结束时间，确认是否是超时导致的问题。

修正后的代码示例 #

done := make(chan bool, 1)
quit := make(chan os.Signal, 1)
// 仅注册需要处理的终止信号，异常崩溃信号无需优雅处理
signal.Notify(quit, os.Interrupt, syscall.SIGINT, syscall.SIGTERM, syscall.SIGHUP, syscall.SIGQUIT)

go func() {
    BootUpLog("waiting for shutdown signal...")
    <-quit
    BootUpLog("shutting down")
    ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second) // 调整合理超时
    defer cancel()
    server.SetKeepAlivesEnabled(false)
    if err := server.Shutdown(ctx); err != nil {
        BootUpLog(fmt.Sprintf("Error in graceful shutdown of the server: %v", err))
    }
    close(done)
}()

if err := server.ListenAndServe(); err != nil && err != http.ErrServerClosed {
    BootUpLog(fmt.Sprintf("shut down with error: %v", err))
}

<-done
BootUpLog("Shutdown gracefully.")

内容的提问来源于stack exchange，提问作者akash agarwal