Golang如何记录panic的完整堆栈_Golang panic stack捕获技巧

P粉602998670 2025-11-30 00:00:00 次阅读

通过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捕获函数

将堆栈捕获逻辑封装成可复用函数，提升代码整洁度。

func capturePanic() {
  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，保持服务可用。