recover必须在defer中调用才有效,且仅对当前goroutine的panic生效;普通调用返回nil,无法捕获panic。

recover 必须在 defer 中调用才有效
Go 没有传统 try/catch,recover 只能在 defer 函数中生效,且仅对当前 goroutine 的 panic 生效。如果写成普通函数调用(比如直接在逻辑里写 recover()),它永远返回 nil,起不到任何作用。
常见错误是把 recover 放在 if 判断里、或放在 panic 后面但没包在 defer 里:
func badExample() {
panic("oops")
recover() // 这行完全无效
}
- 必须用
defer func() { if r := recover(); r != nil { /* 处理 */ } }()包裹 - 如果模块入口是函数(如 HTTP handler、消息处理函数),就在该函数开头加这个 defer
- 注意:不能在内联的匿名函数外层 defer ——
defer recover()是错的,defer func(){recover()}()才对
模块级隔离的关键是 panic 不跨 goroutine 传播
Go 的 panic 默认只终止当前 goroutine,不会影响其他 goroutine。这意味着:只要你不显式用 go f() 在新协程里跑不带 recover 的逻辑,panic 就天然被“模块”(即单个 goroutine 承载的业务单元)隔开了。
典型场景是 HTTP server 或 worker pool:
- 每个 HTTP 请求由独立 goroutine 处理 → 一个请求 panic 不影响其他请求
- 每个 MQ 消息由单独 goroutine 消费 → 单条消息处理崩溃,不影响下一条
- 但如果你在 handler 里启动了子 goroutine(比如
go saveLog()),而子 goroutine panic 且没 recover,它会静默退出,可能造成资源泄漏或状态不一致
所以模块级隔离不是靠 recover 实现的,而是靠 goroutine 边界;recover 只是用来“兜底清理 + 记录”,不让 panic 导致整个进程退出或日志丢失。
文件删除恢复功能 v0.8.0:删除前自动备份文件(存至 `delete_backup/YYYYMMDDHHMM/` 目录),支持从备份中恢复、通过清单(manifest)搜索。具备 SHA256 完整性校验、路径遍历防护及工作区根目录(workspace-root)访问限制。支持自动清理 7 天 / 30 天前的备份。 **v0.8.0:新增 `workspace_cleaner` —— 支持定时清理临时文件,并在删除前自动执行备份。** **v0.7.0:`allowed_roots` 默认值
recover 后不要继续执行原逻辑
很多人误以为 recover 后可以“恢复执行”,比如这样写:
func riskyOp() error {
defer func() {
if r := recover(); r != nil {
log.Printf("recovered: %v", r)
// 错误:这里 return 无法影响外层函数返回值
}
}()
doSomethingThatMightPanic()
return nil // panic 后这行根本不会执行
}
recover 只是让 goroutine 继续运行,但它**不能回退栈帧**。一旦 panic 发生,doSomethingThatMightPanic() 后面的代码全部跳过,你无法“续上”执行。
- recover 后应立即返回错误或重置状态,比如
return errors.New("op failed") - 避免在 recover 块里调用可能再次 panic 的函数(如未判空的 map 访问)
- 不要用 recover 来替代正常错误处理 —— 能用
error返回的,就别 panic
HTTP handler 中 recover 的典型写法
这是最常被问到的落地场景。核心原则:每个 handler 自己负责自己的 panic 隔离,不依赖中间件(除非你明确要统一处理)。
func myHandler(w http.ResponseWriter, r *http.Request) {
defer func() {
if r := recover(); r != nil {
log.Printf("panic in myHandler: %+v", r)
http.Error(w, "Internal Server Error", http.StatusInternalServerError)
}
}()
// 正常业务逻辑
result := riskyCalculation()
json.NewEncoder(w).Encode(result)
}
- 注意:log 要打全栈(用
%+v或debug.PrintStack()),否则很难定位 panic 点 - 不要在 recover 块里调用
w.Write()前没检查http.ResponseWriter是否已写入(可能 panic 发生在 Write 之后) - 如果用了 Gin/Echo 等框架,它们的 recovery 中间件本质也是这个模式,但会隐藏细节 —— 真出问题时,你还是得看原始 handler 里的 panic 位置
真正容易被忽略的是:recover 无法捕获 runtime 错误(如 nil pointer dereference 在某些优化级别下可能被编译器提前报错)、CGO 崩溃、或 syscall 层面的 segfault。这些情况 recover 完全无效,模块隔离也就失效了。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










