如何用Golang实现统一异常捕获_Golang 统一异常捕获实践-Golang-PHP中文网

如何用Golang实现统一异常捕获_Golang 统一异常捕获实践

P粉602998670

发布： 2025-11-18 00:51:30

原创

870人浏览过

使用defer和recover实现异常捕获，通过中间件统一处理panic，结合debug.Stack()记录堆栈信息，提升服务稳定性与可维护性。

如何用golang实现统一异常捕获_golang 统一异常捕获实践

在Go语言中，没有像Java那样的try-catch机制来处理异常。当程序遇到严重错误（如panic）时，会中断执行流程。为了保证服务的稳定性，尤其是在Web服务中，我们需要实现统一的异常捕获机制，防止因未处理的panic导致整个服务崩溃。

使用defer和recover实现函数级异常捕获

Go通过defer配合recover实现运行时异常的捕获。在可能出错的函数或中间件中，使用defer注册一个匿名函数，并在其中调用recover来拦截panic。

以下是一个基础示例：

func safeHandler() {
    defer func() {
        if err := recover(); err != nil {
            log.Printf("捕获到panic: %v", err)
            // 可以在此做上报、记录堆栈等操作
        }
    }()
    // 模拟可能出现panic的代码
    panic("测试panic")
}

登录后复制

在HTTP服务中实现全局异常恢复中间件

对于Web应用（如使用net/http或Gin框架），推荐将recover逻辑封装成中间件，统一处理所有处理器中的panic。

立即学习“go语言免费学习笔记（深入）”；

以标准库为例：

func recoverMiddleware(next http.HandlerFunc) http.HandlerFunc {
    return func(w http.ResponseWriter, r *http.Request) {
        defer func() {
            if err := recover(); err != nil {
                log.Printf("请求发生panic: %s %s - %v", r.Method, r.URL.Path, err)
                http.Error(w, "Internal Server Error", 500)
            }
        }()
        next(w, r)
    }
}
<p>// 使用方式
http.HandleFunc("/test", recoverMiddleware(func(w http.ResponseWriter, r *http.Request) {
panic("oops")
}))</p>

登录后复制

若使用Gin框架，可写为：

千面视频动捕

千面视频动捕是一个AI视频动捕解决方案，专注于将视频中的人体关节二维信息转化为三维模型动作。

查看详情

func RecoveryMiddleware() gin.HandlerFunc {
    return func(c *gin.Context) {
        defer func() {
            if err := recover(); err != nil {
                log.Printf("Panic: %v", err)
                c.JSON(500, gin.H{"error": "Internal error"})
                c.Abort()
            }
        }
        c.Next()
    }
}
<p>// 注册中间件
r := gin.New()
r.Use(RecoveryMiddleware())</p>

登录后复制

捕获堆栈信息以便排查问题

单纯的recover只能拿到panic值，为了定位问题，建议打印完整的调用堆栈。

可以借助runtime/debug.Stack()获取详细堆栈：

import "runtime/debug"
<p>defer func() {
if err := recover(); err != nil {
log.Printf("Panic: %v\nStack:\n%s", err, debug.Stack())
// 发送到日志系统或监控平台
}
}()</p>

登录后复制

这样可以在日志中看到具体是哪一行代码引发了panic，极大提升排查效率。