recover不是全局兜底开关,仅对当前goroutine生效,必须在每个HTTP handler或中间件中显式部署defer+recover,否则panic会杀掉该连接协程;虽不影响其他请求,但资源泄漏可能引发服务雪崩。

recover 在 Web 服务中不是兜底开关,它只对当前 goroutine 生效,必须在每个 handler 或中间件里显式部署,否则 panic 会直接杀掉该连接协程,但不会影响其他请求——可服务整体仍可能因资源泄漏而雪崩。
HTTP handler 内必须自己加 defer+recover
Go 的 http.ServeMux 和大多数框架(如 Gin、Echo)在分发请求时,会为每个请求启动独立 goroutine。这意味着 main 函数里的 defer func() { recover() }() 完全无效。
- 错误写法:在
main()里写一次recover,以为能“全局捕获” - 正确做法:每个 handler 函数开头就加
defer func() { if r := recover(); r != nil { /* 记录日志 + 返回 500 */ } }() - 更优解:封装成中间件,比如 Gin 的
gin.Recovery()就是把这段逻辑注入到 handler 执行链末尾 - 注意:recover 后不能继续用已损坏的局部变量(如被 panic 中断的 map 写入、未关闭的
http.ResponseWriter),必须立即返回或降级
recover 捕获后必须配合熔断与 Shutdown
单纯 recover 只是止血,不是治疗。高频 panic 往往意味着服务已进入不稳定态,硬扛会导致 goroutine 泄漏、连接堆积、内存持续增长。
文件删除恢复功能 v0.8.0:删除前自动备份文件(存至 `delete_backup/YYYYMMDDHHMM/` 目录),支持从备份中恢复、通过清单(manifest)搜索。具备 SHA256 完整性校验、路径遍历防护及工作区根目录(workspace-root)访问限制。支持自动清理 7 天 / 30 天前的备份。 **v0.8.0:新增 `workspace_cleaner` —— 支持定时清理临时文件,并在删除前自动执行备份。** **v0.7.0:`allowed_roots` 默认值
- 每次
recover后,必须调用熔断器的MarkFailed()(如gobreaker的cb.MarkFailed()),否则失败计数不累积,熔断永远不会触发 - 若 panic 率超过阈值(例如 5 分钟内 20% 请求 panic),应通过
sync.Once触发srv.Shutdown(),停止接收新请求 - 别用
os.Exit()—— k8s 会判定为 crashloop,反复重启;要用优雅关机,超时建议设为 10–30 秒 - Shutdown 前务必确保所有活跃连接自然结束,否则会丢请求
recover 不等于 error 处理,别混用
recover 针对的是本不该发生的运行时崩溃(如空指针、切片越界、map 并发写),不是业务错误。把它当 error 用,会掩盖真正的问题。
- 不要在公共 API 函数里用
recover捕获调用者传入的回调函数 panic —— 你无法保证其状态安全,可能留下锁未释放、文件未关闭等隐患 - 不要用
recover替代if err != nil;除零、I/O 错误、JSON 解析失败等都该走error路径 - panic 的典型适用场景:配置加载失败且后续逻辑完全无法执行、数据库 schema 严重不匹配、核心依赖模块初始化失败
- recover 后的日志建议包含
runtime.Stack(),但生产环境要限制堆栈长度,避免日志刷爆磁盘
最常被忽略的一点:recover 成功后,原函数已终止,panic 后面的代码不会执行;但 defer 函数里的其他语句仍会跑完——如果你在 defer 里既 recover 又 close 文件,又忘了检查 r != nil 就 close,可能造成 double-close panic。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










