Go Academy · 课时

优雅关闭

Q: 「优雅关闭」这节课中我会学到什么？

处理操作系统信号并排空连接 你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

处理操作系统信号并排空连接

优雅关闭 是 CoddyKit 上的免费 Go Academy 课时。这是第 4 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Go Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Go Academy 课程共包含 4 节课。

为什么要优雅关闭？

调用 os.Exit 或直接停止服务器会丢弃所有正在处理的请求。优雅关闭会等待活动请求完成后再退出。

http.Server.Shutdown

srv.Shutdown(ctx) 会停止接受新连接，等待活动请求完成，然后返回。请传入带截止时间的上下文，以限制等待时间。

ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
defer cancel()
srv.Shutdown(ctx)

信号处理

请在协程中监听 SIGINT/SIGTERM，收到信号后调用 Shutdown：

quit := make(chan os.Signal, 1)
signal.Notify(quit, syscall.SIGINT, syscall.SIGTERM)
<-quit
log.Println("shutting down...")
srv.Shutdown(ctx)

完整的优雅关闭模式

在协程中启动服务器；阻塞等待信号通道；然后执行关闭：

go func() {
    if err := srv.ListenAndServe(); err != http.ErrServerClosed {
        log.Fatal(err)
    }
}()

quit := make(chan os.Signal, 1)
signal.Notify(quit, syscall.SIGINT, syscall.SIGTERM)
<-quit
srv.Shutdown(ctx)

http.ErrServerClosed

调用 Shutdown 后，ListenAndServe 会返回 http.ErrServerClosed。请将其视为正常退出，而不是错误。

排空连接

只有当处理程序本身遵守上下文取消时，Shutdown 才会等待所有被接管的连接和活动 WebSocket 连接。长轮询或流式处理程序必须检查 r.Context().Done()。

关闭超时

请设置合理的关闭超时时间（10–30 秒）。如果截止时间过后请求仍在运行，Shutdown 会返回 context.DeadlineExceeded，并强制关闭剩余连接。

关闭时清理

Shutdown 返回后，请依次关闭数据库连接池、刷新日志缓冲区并释放其他资源。可以使用 defer 或显式排序。

srv.Shutdown(ctx)
db.Close()
logger.Sync()

Server.Close 与 Server.Shutdown

srv.Close() 会立即关闭所有连接而不等待。只有在可以接受强制停止时才使用它（例如在测试中）。

Kubernetes 就绪探针

在关闭期间，请在调用 Shutdown 之前将就绪探针更新为返回 503。这会通知负载均衡器停止将新请求路由到该 Pod。

多个服务器

如果运行多个服务器（HTTP + gRPC + 指标），请使用协程并发关闭每个服务器，并使用 WaitGroup 等待它们全部排空。

快速检查

http.Server.Shutdown 会执行什么操作？

回顾：优雅关闭

关键要点：

srv.Shutdown(ctx) 停止新连接并等待活动连接完成
使用 signal.Notify 监听 SIGINT/SIGTERM
关闭时 ListenAndServe 返回 http.ErrServerClosed — 这不是错误
设置关闭截止时间，避免无限等待

常见问题解答

「优雅关闭」课时是免费的吗？

是的 — 「优雅关闭」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Go Academy 课程的其余内容，请升级到 CoddyKit PRO。 Go Academy 课程共包含 4 节课。

「优雅关闭」这节课中我会学到什么？

处理操作系统信号并排空连接你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Go Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Go Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 4 节课，共 4 节。

「优雅关闭」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Go Academy 课中编写并运行代码吗？

能。每节 Go Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Go Academy