Beego 的 recoverpanic 配置仅是基础开关,无法满足生产可观测性要求;必须在每个 controller 方法(如 Get/Post)开头显式 defer 自定义 recover,确保当前 goroutine 中 panic 被捕获并记录 traceID、触发告警、集成日志中间件。

Beego 的 recoverpanic 配置只是开关,不是完整解决方案
Beego 默认开启 recoverpanic = true,但它只做最基础的 panic 恢复:打印堆栈、返回 500 页面,不记录 traceID、不触发告警、不调用你自己的日志中间件。它无法满足生产环境对可观测性和故障响应的要求。
这个配置本质是 Beego 内部在每个 controller 方法入口自动加了一层 defer recoverPanic(),但它的实现不可扩展、不可定制,且日志格式固定、无上下文字段(如请求 ID、用户信息)。
- 它不会拦截你在
Init()、Prepare()或自定义 goroutine 中触发的 panic - 它不支持按 panic 类型分流(比如业务 panic 和系统 panic 区别处理)
- 它无法阻止中间件链在 panic 后提前终止——比如日志中间件没机会写入完成状态
必须在每个 controller 方法里手动 defer recover
Beego 的每个 HTTP 请求都在独立 goroutine 中执行,main 函数里的 defer recover() 完全无效。唯一可靠的方式,是在你真正要保护的 handler 方法(如 Get()、Post())内部显式写 defer。
这不是“重复劳动”,而是 Beego 设计决定的约束:框架不替你做跨 goroutine 的恢复,你得自己负责当前请求的 goroutine 边界。
-
defer必须放在方法最开头,确保在任何可能 panic 的代码前注册 -
recover()必须直接调用,不能赋值给变量再调,也不能包装进另一个函数里 - 如果用了
c.Data["json"] = ...或c.ServeJSON()等已写响应头的操作,再调http.Error()会二次 panic,需先检查c.Ctx.ResponseWriter.Header().Get("Content-Type")是否为空
推荐封装成可复用的 controller 基类方法
手动在每个 Get() 里写 defer 容易遗漏或写错。更稳妥的做法是把恢复逻辑抽成基类方法,在子 controller 中统一调用。
示例:
func (c *BaseController) RecoverPanic() {
defer func() {
if r := recover(); r != nil {
buf := debug.Stack()
log.Printf("[PANIC] %s %s: %v\n%s", c.Ctx.Input.Method(), c.Ctx.Input.URL(), r, buf)
// 这里可集成 Sentry、发送邮件、上报 Prometheus
c.Abort("500")
}
}()
}
然后在子 controller 中:
func (c *UserController) Get() {
c.RecoverPanic() // 必须第一行
// 后续业务逻辑...
}
- 不要试图用 Beego 的
Filter实现全局 recovery——Filter 是在 controller 实例化后、方法调用前执行,但 panic 可能发生在Prepare()或Init(),Filter 捕不到 - 如果你用了 Beego 的
AutoRouter或NSRouter,确保所有路由最终落到继承自BaseController的类型上 - 注意
c.Abort("500")不会立即中断执行,它只是标记后续中间件跳过;你要确保业务逻辑不依赖 abort 后的副作用
recover 后不能“继续执行”,但可以降级返回
Go 的 recover() 不是 try-catch,它只让函数从 panic 点退出,不会回滚 map 修改、channel 发送、文件写入等已发生的副作用。所以别指望“捕获后重试”或“回退到默认值”。
真正可行的模式是:捕获 panic → 记录上下文 → 返回预设降级响应(如空数据、兜底文案、HTTP 500)。
- 不要在
recover块里调c.TplName或c.Redirect(),这些操作可能再次 panic(比如模板未加载) - 如果 panic 来自第三方库(如 ORM 查询),优先查文档看是否提供 error 返回路径,而不是强行 recover
- 对空指针、切片越界这类系统 panic,recover 后应立刻终止服务(比如调
os.Exit(1)),因为程序状态已不可信——这点 Beego 默认机制完全忽略


















