通过defer + recover + runtime.Stack可捕获panic并输出完整堆栈，用于快速定位Go程序中的不可恢复错误。
在Go语言开发中，panic虽然不推荐作为常规错误处理手段，但在某些不可恢复的错误场景下仍可能发生。为了快速定位问题，捕获panic并记录完整的堆栈信息至关重要。直接使用recover只能拿到panic值，无法自动输出调用堆栈，需要借助runtime包来实现完整堆栈追踪。
使用defer + recover + runtime.Stack捕获堆栈
核心思路是在可能触发panic的函数或HTTP中间件中，通过defer注册一个recover函数，并在其中调用runtime.Stack获取当前goroutine的完整堆栈。
示例代码：
func safeCall() {defer func() {
if r := recover(); r != nil {
fmt.Printf("panic recovered: %v\n", r)
buf := make([]byte, 4096)
runtime.Stack(buf, false)
fmt.Printf("stack trace:\n%s", buf)
}
}()
// 可能引发panic的代码
panic("something went wrong")
}
说明：
- runtime.Stack(buf, false) 第二个参数为false表示只打印当前goroutine的堆栈，true则打印所有goroutine。
- buf大小建议设为4096或更大，避免截断。
- 堆栈信息会包含文件名、行号和函数调用链，便于定位原始出错位置。
封装通用的panic捕获函数
将堆栈捕获逻辑封装成可复用函数，提升代码整洁度。
立即学习“go语言免费学习笔记（深入）”；
if r := recover(); r != nil {
log.Printf("panic: %v\n", r)
stack := make([]byte, 4096)
n := runtime.Stack(stack, true)
log.Printf("full stack:\n%s", stack[:n])
}
}
之后在任意defer中调用：defer capturePanic()
在HTTP服务中全局捕获panic
Web服务中常通过中间件统一处理panic，避免进程崩溃。
func recoverMiddleware(next http.Handler) http.Handler {return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
defer func() {
if r := recover(); r != nil {
log.Printf("panic in request: %v", r)
stack := make([]byte, 4096)
runtime.Stack(stack, false)
log.Printf("stack trace:\n%s", stack)
http.Error(w, "Internal Server Error", 500)
}
}()
next.ServeHTTP(w, r)
})
}
这样即使某个handler触发panic，也能记录日志并返回500，保持服务可用。
注意事项与技巧
- 尽量不在热点路径使用recover，影响性能。
- 测试时可主动触发panic验证堆栈是否正确输出。
- 结合zap、logrus等结构化日志库，将panic和堆栈作为独立字段记录，方便检索。
- 注意goroutine中的panic不会被外层普通defer捕获，每个goroutine需单独加recover。
基本上就这些。只要在关键入口处加上recover+runtime.Stack，就能有效捕捉线上panic的完整上下文。不复杂但容易忽略。
