Golang系统事件钩子实现程序启动与关闭逻辑-Golang-PHP中文网

go程序通过os.signal和signal.notify捕获sigint、sigterm等信号实现优雅启停；启动逻辑应封装为显式函数并在main中调用，避免硬编码或使用init；shutdown需用defer注册，确保资源清理。

golang系统事件钩子实现程序启动与关闭逻辑

Go 程序如何监听系统信号实现优雅启停

Go 本身没有“系统事件钩子”概念，但通过 os.Signal 和 signal.Notify 可以精准捕获 SIGINT（Ctrl+C）、SIGTERM（kill 默认信号）等关键系统信号，这是实现启动初始化与关闭清理的通用且可靠方式。

启动逻辑该放哪？别在 main() 开头硬编码

启动逻辑（如加载配置、连接数据库、注册服务）应封装为独立函数，而非堆在 main() 开头。否则一旦关闭流程触发，无法保证它已执行完毕，容易导致清理时访问未初始化资源。

用 init() 不合适：它无返回值、不能报错、无法等待异步依赖就绪
推荐模式：main() 中调用显式启动函数，检查错误并提前退出

示例：

func main() {
    if err := startup(); err != nil {
        log.Fatal(err)
    }
    defer shutdown() // 注意：defer 在 main return 或 panic 时才执行

    signal.Notify(<code>sigChan</code>, syscall.SIGINT, syscall.SIGTERM)

shutdown() 里必须阻塞等待清理完成，不能只发 goroutine

常见错误是把关闭逻辑扔进 goroutine 后直接 return —— 主 goroutine 一退出，整个进程就终止，goroutine 被强制杀死，数据库连接没关闭、文件没 flush、HTTP server 没 graceful shutdown。

Golang Spf13 Viper

Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。

下载

http.Server.Shutdown() 必须传入 context 并等待其完成，不能只调 srv.Close()
数据库连接池建议用 db.Close()，它会阻塞直到所有连接归还
自定义资源（如文件句柄、协程池）需设计同步机制，比如用 sync.WaitGroup 或 chan struct{} 等待全部 worker 退出

示例片段：

func shutdown() {
    log.Println("shutting down...")
    ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
    defer cancel()
    
    if err := httpServer.Shutdown(ctx); err != nil {
        log.Printf("HTTP shutdown error: %v", err)
    }
    
    if err := db.Close(); err != nil {
        log.Printf("DB close error: %v", err)
    }
}