Golang Gin怎么做优雅关闭_Golang Gin优雅停机教程【收藏】-Golang-PHP中文网

gin 本身无内置优雅关闭，需用 http.server.shutdown() 配合 signal 监听和 context 超时，手动管理所有 goroutine 退出；漏掉任一环节（如 ticker、db、redis 或子 goroutine 未响应 ctx.done）将导致进程卡住。

golang gin怎么做优雅关闭_golang gin优雅停机教程【收藏】

直接说结论：Gin 本身没有内置优雅关闭逻辑，router.Run() 是阻塞式启动，无法手动干预；真正起作用的是标准库 http.Server 的 Shutdown() 方法，配合 os/signal 监听信号，再手动管理所有长期 goroutine 的退出——漏掉任何一环，“优雅”就只是假象。

为什么 `router.Run()` 不能用于优雅关闭

router.Run() 内部调用的是 http.ListenAndServe()，它会一直阻塞，直到发生错误或进程被强杀。你发 SIGINT（Ctrl+C）或 SIGTERM，程序直接退出，正在处理的请求被中断，连接被重置，数据库事务可能没提交，定时任务还在后台跑……根本谈不上“优雅”。

必须改用 http.Server 显式构造服务实例，才能调用 Shutdown()
Shutdown() 不会自动等待你的业务 goroutine，只管 HTTP 连接层
别在 Shutdown() 后立刻 os.Exit()，要等自定义清理完成

怎么用 `http.Server.Shutdown()` 配合信号监听

核心是三件事：启动服务、监听信号、触发关闭。关键细节全在 channel 缓冲和 context 超时上。

用 make(chan os.Signal, 1) 创建带缓冲的 signal channel，否则首次信号可能丢失
只监听 syscall.SIGINT 和 syscall.SIGTERM，别加 SIGHUP 等无关信号
Shutdown() 必须传入带超时的 context.Context，比如 context.WithTimeout(ctx, 10*time.Second)，防止卡死
调用 Shutdown() 后，要 select 等待它返回，不能直接往下走

示例关键片段：

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

srv := &http.Server{Addr: ":8080", Handler: router}
go func() {
    if err := srv.ListenAndServe(); err != nil && err != http.ErrServerClosed {
        log.Fatalf("listen: %v", err)
    }
}()

sigChan := make(chan os.Signal, 1)
signal.Notify(sigChan, syscall.SIGINT, syscall.SIGTERM)


<h3>哪些 goroutine 容易被忽略导致进程卡住</h3>
<p>HTTP Server 关了，不代表你的程序能退出。下面这些常见组件若没显式关，进程会 hang 住：</p>