Gin的panic不会自动被recover捕获，因为其Recovery中间件仅包裹handler链，不覆盖http.Server.Serve()、全局钩子、第三方库异步调用等外部panic场景；未被任何recover拦截的panic必然导致进程崩溃。
为什么Gin的panic不会自动被recover捕获
Gin默认只对handler函数内部的panic做recover，但外部中间件、全局钩子、或router.Run()之后的代码一旦panic，整个进程就直接崩溃。这不是Gin的bug，而是Go运行时行为——panic未被任何recover()拦截时必然退出。
常见触发场景包括：在gin.Engine初始化后误调用panic()、第三方库在HTTP服务启动后异步panic、或在http.Server的ConnState回调里出错。
- 不要依赖
gin.Default()自带的Recovery()中间件来兜底所有panic -
Recovery()只包裹handler chain，不包裹http.Server.Serve()本身 - 若使用
http.Server手动启动（如配置TLS、超时），必须自己加顶层recover
如何给http.Server加顶层panic恢复
最稳妥的方式是把http.Server.ListenAndServe()或ListenAndServeTLS()包进一个带recover()的goroutine里，避免主线程崩溃。
go func() {
if err := server.ListenAndServe(); err != nil && err != http.ErrServerClosed {
log.Printf("server error: %v", err)
}
}()
// 启动前加defer recover
go func() {
defer func() {
if r := recover(); r != nil {
log.Printf("unexpected panic in http.Server: %v", r)
}
}()
if err := server.ListenAndServe(); err != nil && err != http.ErrServerClosed {
log.Printf("server error: %v", err)
}
}()
- 必须在
go协程内做recover()，因为ListenAndServe是阻塞调用 - 不能在main goroutine里defer recover——它根本等不到panic发生就卡住了
- 记得判断
err == http.ErrServerClosed，这是正常关机信号，不是错误
自定义Router.NotFound和.Router.MethodNotAllowed不处理panic
router.NoRoute()和router.NoMethod()注册的handler，和普通路由handler一样受Recovery()中间件保护。但如果你在这些handler里主动调用panic()，或者它们调用的下游函数panic，依然会被捕获——前提是Recovery()已启用且位于中间件链前端。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
-
Recovery()必须在NoRoute()之前注册，否则无效 - 别在
NoRoute()handler里写log.Fatal()，它会直接终止进程，绕过所有recover - 如果用了
gin.New()而非gin.Default()，要手动加Use(gin.Recovery())
第三方中间件或Hook里的panic怎么抓
Gin的Use()添加的中间件、router.Any()注册的全局handler、甚至http.Server.RegisterOnShutdown()回调，只要没被Recovery()包裹，panic就会逃逸。尤其注意日志中间件、JWT验证、或DB连接池健康检查这类常被忽略的环节。
- 所有自定义中间件开头加
defer func(){if r:=recover();r!=nil{...}}() - 避免在
http.Server.Handler之外的地方调用可能panic的函数（比如template.ParseFiles()放在main()里就危险） - 用
go run -gcflags="-m" main.go检查是否意外逃逸了闭包引用，导致recover失效
真正难防的是Cgo调用、syscall异常、或内存耗尽——这些recover不了，得靠监控和进程管理工具兜底。
