Iris的Run()不支持优雅关闭，因其阻塞式调用http.ListenAndServe()且未暴露*http.Server实例；必须用iris.New()配合手动创建*http.Server并调用Shutdown()实现。
为什么 iris.Run() 不能直接支持优雅关闭
因为 iris.Run() 是阻塞式启动，内部调用 http.ListenAndServe()，没有暴露底层 *http.Server 实例，也就无法调用 Shutdown()。想做优雅关闭，必须绕过它，自己构造并管理 *http.Server。
手动创建 *http.Server 并调用 Shutdown()
核心是用 iris.New() 创建 app，再通过 iris.ToStd() 或直接获取 app.Handler() 绑定到自定义 *http.Server。关键点：
-
iris.New()返回的 app 不会自动监听，适合手动控制生命周期 - 必须设置
ReadTimeout、WriteTimeout和IdleTimeout，否则Shutdown()可能无限等待空闲连接 - 信号监听建议用
os.Interrupt和syscall.SIGTERM，避免 Ctrl+C 被忽略
示例片段：
app := iris.New()
app.Get("/ping", func(ctx iris.Context) {
ctx.WriteString("pong")
})
<p>srv := &http.Server{
Addr: ":8080",
Handler: app,
ReadTimeout: 5 <em> time.Second,
WriteTimeout: 10 </em> time.Second,
IdleTimeout: 120 * time.Second,
}</p><p>go func() {
if err := srv.ListenAndServe(); err != nil && err != http.ErrServerClosed {
log.Fatal(err)
}
}()</p><p>// 等待中断信号
quit := make(chan os.Signal, 1)
signal.Notify(quit, os.Interrupt, syscall.SIGTERM)
<-quit</p><p>log.Println("shutting down server...")
ctx, cancel := context.WithTimeout(context.Background(), 15*time.Second)
defer cancel()
if err := srv.Shutdown(ctx); err != nil {
log.Fatal("server shutdown error:", err)
}
使用 iris.Application.RegisterOnInterrupt() 的陷阱
这个方法看似方便，但它注册的是进程级中断回调，并不等价于服务器优雅关闭 —— 它不会触发 Shutdown()，也不会等待活跃请求结束，只是「在收到信号时执行一段函数」。常见误用：
- 在里面直接调用
os.Exit(0)：请求被粗暴中断，客户端收不到响应 - 在里面调用
srv.Close()（已废弃）：连接立即断开，不是优雅关闭 - 没配合
context控制超时：回调函数卡住，进程无法退出
它只适合做清理日志、释放非 HTTP 资源等辅助工作，不能替代 srv.Shutdown()。
HTTP/2 和 TLS 场景下的额外注意点
如果启用了 HTTPS 或 HTTP/2，Shutdown() 行为基本一致，但有两点容易漏：
- 若用
srv.ListenAndServeTLS()，确保证书文件路径在关闭前仍可读，否则Shutdown()可能 panic（极少见，但日志里会出现accept tcp: use of closed network connection） - HTTP/2 的连接复用可能导致某些长连接延迟关闭，
IdleTimeout必须显式设小（如 30s），否则Shutdown()等待时间远超预期 - 不要在
Shutdown()后再调用srv.Close()：会报http: Server closed错误，纯属冗余
优雅关闭真正难的不是写几行代码，而是把超时参数、信号捕获、上下文取消、资源清理这四件事串成一条不漏的链路。少设一个 IdleTimeout，就可能让服务停不下来。
