当前位置：首页 > 文章列表 > Golang > Go教程 > Golang统一异常捕获方法详解

Golang统一异常捕获方法详解

2025-12-04 12:15:46 0浏览收藏

推广推荐

支持 PC / 移动端，安全直达

最近发现不少小伙伴都对Golang很感兴趣，所以今天继续给大家介绍Golang相关的知识，本文《Golang统一异常捕获方法解析》主要内容涉及到等等知识点，希望能帮到你！当然如果阅读本文时存在不同想法，可以在评论中表达，但是请勿使用过激的措辞~

使用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。

以标准库为例：

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框架，可写为：

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，极大提升排查效率。