在Golang程序运行中,panic是表示程序遇到无法继续执行的严重错误的机制,如果不做任何处理,程序会直接崩溃并输出简单的错误信息,不利于问题排查。我们可以通过recover结合defer来捕获panic,同时获取完整的堆栈信息并打印成日志。

panic与recover的基本机制
Golang中panic会终止当前函数的执行,然后向上层调用栈逐层返回,直到整个程序崩溃。而recover是内建函数,只能在defer修饰的函数中生效,用来捕获当前goroutine的panic,返回panic传递的值。
需要注意的是,recover只有在defer函数中直接调用才会生效,嵌套调用或者不在defer中调用都无法捕获panic。下面是最基础的捕获示例:
package main
import "fmt"
func main() {
// defer函数中使用recover捕获panic
defer func() {
if err := recover(); err != nil {
fmt.Printf("捕获到panic: %vn", err)
}
}()
// 触发panic
panic("测试panic错误")
}
获取完整的panic堆栈信息
上面的示例只能拿到panic传递的错误值,无法知道panic发生的具体位置和调用栈,实际排查问题时需要完整的堆栈信息。Golang的runtime/debug包提供了Stack函数,可以获取当前的堆栈信息。
我们可以在捕获到panic后,调用debug.Stack()获取堆栈字节切片,然后和panic的错误信息一起打印。示例如下:
package main
import (
"fmt"
"runtime/debug"
)
func main() {
defer func() {
if err := recover(); err != nil {
// 获取堆栈信息
stack := debug.Stack()
// 拼接错误信息和堆栈
logContent := fmt.Sprintf("panic错误: %vn堆栈信息:n%s", err, stack)
fmt.Println(logContent)
// 这里可以将logContent写入日志文件或者发送到日志系统
}
}()
// 模拟多层调用后触发panic
funcA()
}
func funcA() {
funcB()
}
func funcB() {
panic("业务逻辑异常")
}
封装通用的panic捕获函数
如果每个可能触发panic的地方都写一遍defer和recover逻辑会非常冗余,我们可以封装一个通用的捕获函数,在程序启动或者goroutine执行时统一调用。
如果是http服务,还可以在中间件中使用这个逻辑,捕获请求处理过程中的panic,避免单个请求异常导致整个服务崩溃。封装示例如下:
package main
import (
"fmt"
"runtime/debug"
"log"
)
// 捕获panic并打印日志的通用函数
func CatchPanic() {
if err := recover(); err != nil {
stack := debug.Stack()
// 这里可以替换为实际的日志输出逻辑,比如写入文件、上报监控系统
log.Printf("捕获到panic: %vn堆栈信息:n%s", err, stack)
}
}
func main() {
// 主goroutine中使用
defer CatchPanic()
// 启动子goroutine也加上捕获逻辑
go func() {
defer CatchPanic()
// 子goroutine中的业务逻辑
panic("子goroutine异常")
}()
// 主goroutine的业务逻辑
panic("主goroutine异常")
}
注意事项
- recover只能捕获当前goroutine的panic,不同goroutine之间的panic无法互相捕获,所以每个启动的goroutine都需要单独添加defer recover逻辑。
- 不要滥用recover,panic本身是严重错误的信号,捕获后应该记录完整信息,而不是默默忽略错误继续执行,否则可能导致程序处于不可预期的状态。
- 如果panic传递的是非error类型的值,recover返回的就是对应的值,打印时需要注意类型适配,避免日志输出异常。
总结
通过defer和recover配合使用,我们可以捕获Golang程序中的panic,结合runtime/debug包的Stack函数可以获取完整的堆栈信息,将错误和堆栈一起打印成日志,就能快速定位问题发生的位置和原因。将捕获逻辑封装成通用函数,可以减少重复代码,提升开发效率。合理使用panic捕获机制,能有效提升程序的健壮性,降低线上问题排查的难度。