Golang捕获panic并记录栈信息方法

在Go语言开发中，panic若未被及时捕获将导致程序整体崩溃，严重影响服务稳定性；本文系统介绍了通过defer+recover机制安全拦截panic的核心方法，并结合debug.Stack()和runtime.Stack灵活获取详细调用栈信息，辅以log记录实现可观测性，还提供了可复用的withRecovery封装方案——无论是日常调试还是高可用线上服务，这套轻量、可靠、易集成的错误恢复实践都能帮你快速定位问题根因，让程序在异常面前依然稳健运行。

在Go语言中，当程序发生严重错误时会触发panic，如果不处理会导致整个程序崩溃。为了增强程序的稳定性，可以在defer函数中使用recover来捕获panic，并结合debug.PrintStack或runtime.Stack记录详细的调用栈信息，便于排查问题。

使用 defer + recover 捕获 panic

在可能发生panic的函数中，通过defer注册一个匿名函数，在其中调用recover()来拦截panic。

一旦捕获到panic，可以将其记录到日志，并打印当前的调用栈。

package main

import (
    "log"
    "runtime/debug"
)

func safeCall() {
    defer func() {
        if r := recover(); r != nil {
            log.Printf("捕获到 panic: %v", r)
            log.Printf("堆栈信息:\n%s", debug.Stack())
        }
    }()

    // 模拟 panic
    panic("测试 panic")
}

func main() {
    safeCall()
    log.Println("程序继续运行")
}

封装通用的 panic 恢复机制

在实际项目中，可以将恢复逻辑封装成一个通用函数，方便在多个地方复用。

例如，在HTTP服务中每个处理器都加上recover机制。

func withRecovery(fn func()) {
    defer func() {
        if r := recover(); r != nil {
            log.Printf("发生 panic: %v", r)
            log.Printf("堆栈跟踪:\n%s", debug.Stack())
        }
    }()
    fn()
}

// 使用方式
func main() {
    withRecovery(func() {
        panic("出错了")
    })
    log.Println("程序未崩溃")
}

获取更精确的栈信息（可选）

如果不想依赖debug.Stack()，也可以使用runtime.Stack手动获取栈信息，更加灵活。

比如控制是否打印当前goroutine的栈，或只获取前几帧。

import (
    "runtime"
)

buf := make([]byte, 4096)
n := runtime.Stack(buf, false) // false 表示只打印当前 goroutine
log.Printf("栈信息:\n%s", buf[:n])

基本上就这些。只要在关键执行路径上加上defer + recover，再配合栈打印，就能有效捕获异常并保留现场信息，对线上服务尤其重要。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Golang捕获panic并记录栈信息方法》文章吧，也可关注golang学习网公众号了解相关技术文章。