Golang中如何捕获并打印panic日志

来源:Java编程网作者:缓存小熊猫头衔:程序员
导读:本期聚焦于小伙伴创作的《Golang中如何捕获并打印panic日志》,敬请观看详情,探索知识的价值。以下视频、文章将为您系统阐述其核心内容与价值。如果您觉得《Golang中如何捕获并打印panic日志》有用,将其分享出去将是对创作者最好的鼓励。

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

Golang中如何捕获并打印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捕获机制,能有效提升程序的健壮性,降低线上问题排查的难度。

Golangrecoverpanicpanic_日志修改时间:2026-06-29 12:24:16

免责声明:​ 已尽一切努力确保本网站所含信息的准确性。网站内容多为原创整理与精心编撰,观点力求客观中立。本站旨在免费分享,内容仅供个人学习、研究或参考使用。若引用了第三方作品,版权归原作者所有。如内容涉及您的权益,请联系我们处理。
内容垂直聚焦
专注技术核心技术栏目,确保每篇文章深度聚焦于实用技能。从代码技巧到架构设计,为用户提供无干扰的纯技术知识沉淀,精准满足专业提升需求。
知识结构清晰
覆盖从开发到部署的全链路。AI、前端、编程、数据库、服务器、建站、系统层层递进,构建清晰学习路径,帮助用户系统化掌握开发与运维所需的核心技术。
深度技术解析
拒绝泛泛而谈,深入技术细节与实践难点。无论是数据库优化还是服务器配置,均结合真实场景与代码示例进行剖析,致力于提供可直接应用于工作的解决方案。
专业领域覆盖
精准对应开发生命周期。从前端界面到后端编程,从数据库操作到服务器运维,形成完整闭环,一站式满足全栈工程师和运维人员的技术需求。
即学即用高效
内容强调实操性,步骤清晰、代码完整。用户可根据教程直接复现和应用于自身项目,显著缩短从学习到实践的距离,快速解决开发中的具体问题。
持续更新保障
专注既定技术方向进行长期、稳定的内容输出。确保各栏目技术文章持续更新迭代,紧跟主流技术发展趋势,为用户提供经久不衰的学习价值。