Revel 的 panic 恢复仅作用于主请求 goroutine,子 goroutine panic 会直接终止进程且无日志;需在 init() 中手动 defer recover,对所有 go 调用统一用 safeGo 包装并内嵌 debug.Stack()。

Revel 的 panic 恢复机制不是“自动全局生效”的,它只对主请求 goroutine 有效,子 goroutine 中的 panic 会被 runtime 直接终止且无日志——这是线上服务突然 500 或进程退出却查不到堆栈的根本原因。
revel.PANIC 拦截器只捕获主 goroutine
Revel 的 revel.InterceptFunc(recoverPanic, revel.PANIC) 是在 HTTP handler 执行完毕、返回响应前触发的,它依赖 Go 的 defer + recover 组合,而该组合只能捕获**当前 goroutine** 的 panic。这意味着:
- HTTP handler 函数体内直接 panic(如空指针解引用、数组越界)能被拦截并转为 500 响应
-
go func() { panic("oops") }()这类子 goroutine 的 panic 完全逃逸,不会触发任何拦截器 - 第三方 SDK 回调(如
database/sql的Rows.Close()错误回调、Redis pub/sub 的 handler)也运行在独立 goroutine,同样不被捕获
为什么 init() 里加 defer recover 很关键
Revel 应用启动时,app/init.go 的 init() 函数会在 main goroutine 中执行。如果这里发生 panic(比如配置加载失败、DB 连接初始化异常),整个进程会立即退出,且默认无堆栈输出——因为 Revel 的 PANIC 拦截器此时还没注册。
必须手动补上:
func init() {
defer func() {
if r := recover(); r != nil {
log.Panicf("init panic: %v\n%v", r, debug.Stack())
}
}()
// ... 其余初始化代码
}这一步确保了启动失败时至少能看到完整调用链,而不是黑屏退出。
safeGo 是子 goroutine panic 的唯一可控方案
裸写 go 是 Revel 项目中最常见的 panic 隐藏点。不能靠“尽量不 panic”来规避,而要统一用 safeGo 包装:
- 全局搜索所有
go(注意结尾空格,避免匹配到goto) - 把
go sendEmail()改成safeGo(sendEmail) - 把
time.AfterFunc(5*time.Second, cleanup)也改成safeGo(cleanup),因为其回调也在新 goroutine -
safeGo内部必须调用debug.Stack(),只打印r值无法定位问题行号
第三方库的异步回调同理:哪怕用了 github.com/go-redis/redis/v9 的 PubSub.ReceiveMessage,只要它启动 goroutine 处理消息,你就得自己 wrap。
recover 必须在 defer 函数体内直接调用
这是 Go 语言级限制,和 Revel 无关,但常被忽略:
- ✅ 正确:
defer func() { recover() }() - ❌ 错误:
defer recover()或defer someWrapper()(其中someWrapper内部调用recover)
Revel 的 recoverPanic 函数之所以能工作,是因为它本身就是一个被 defer 包裹的闭包。如果你自定义拦截器,务必检查 recover() 是否出现在最内层 defer 函数体中,否则永远返回 nil。
真正难排查的 panic,往往藏在别人写的 goroutine 里;而你唯一能做的,就是让每个 goroutine 都带上自己的 recover —— 不是靠框架,而是靠代码规范和搜索习惯。


















