第三方库panic recover不到，是因为recover必须在panic前于同一goroutine中注册defer，而库内部panic可能因注册过晚、提前return、异步goroutine或深层调用逃逸导致捕获失败。
第三方库panic为什么recover不到
第三方库（比如 json.Unmarshal、template.Execute、yaml.Unmarshal）在输入非法时主动调用 panic，但你写了 defer recover() 却没捕获到——根本原因是：这些 panic 发生在库内部的深层调用栈里，而你的 recover() 虽在同一 goroutine，但可能注册太晚，或被中间某层提前 return / 逃逸。
更常见的是：你把 recover() 放在了调用第三方库的函数外层（比如封装函数的 defer），但该函数本身没有 panic，而是它调用的库 panic 了——只要 panic 没跳出当前 goroutine，理论上能捕获；但若库用了内部 goroutine（如某些异步解析器）、或你在 defer 前已 return，就彻底失效。
-
recover()必须在 panic 触发前、同一 goroutine 中已注册好 defer，且该 defer 尚未执行完毕 - 不要依赖“上层函数包一层就安全”，必须确保 defer 语句出现在所有可能触发 panic 的代码之前
- 部分库（如旧版
gopkg.in/yaml.v2）会在 map 并发写入时 panic，这种 runtime panic 更难预测，需额外加锁或预校验
如何安全调用易 panic 的第三方函数
别等 panic 发生再兜底，优先用「防御性调用」替代被动 recover。多数易 panic 的库其实提供 safe 模式或可预检接口。
- 对
json.Unmarshal：先用json.Valid()校验字节流，再解码；或用json.Decoder+DisallowUnknownFields()主动拦截非法字段 - 对
template.Execute：提前调用t.ExecuteTemplate(ioutil.Discard, name, nil)预编译验证，避免运行时 panic - 对
regexp.Compile：永远用regexp.CompilePOSIX或检查err != nil，绝不依赖 panic 捕获——它本就不该 panic - 若必须用 panic 版本（如某些未暴露 error 的老库），则显式包裹：
func safeUnmarshal(data []byte, v interface{}) (err error) { defer func() { if r := recover(); r != nil { err = fmt.Errorf("panic during json.Unmarshal: %v, stack: %s", r, debug.Stack()) } }() json.Unmarshal(data, v) return }
recover 后怎么保留完整上下文
只记录 r（比如 panic("invalid type")）毫无排查价值。线上故障中，80% 的第三方 panic 定位失败，是因为日志里只有 panic 字符串，没有调用链、traceID、输入快照。
立即学习“go语言免费学习笔记（深入）”；
- 必须用
debug.Stack()或runtime/debug.PrintStack()获取完整堆栈，注意前者返回[]byte，需转string - 在 defer 函数内显式捕获关键变量：比如传入的
data长度、reqID、userID，别依赖闭包自动带出（可能已被 GC 或覆盖） - 结构化日志字段要包含：
"panic_value"、"stack"、"input_len"、"lib_name"、"trace_id" - 避免在 recover 里做重试或修复逻辑——状态可能已损坏，记录+上报+快速失败才是正解
哪些第三方库 panic 根本不该发生
有些库 panic 是设计缺陷，不是你该兜底的场景。强行 recover 只会让问题更隐蔽。
-
github.com/golang/protobuf/jsonpb（已归档）：对非法 proto 字段 panic，应升级到google.golang.org/protobuf/encoding/protojson并检查UnmarshalOptions -
gopkg.in/mgo.v2：连接中断时 panic，正确做法是用session.Copy().Close()管理生命周期，而非 recover - 任何用
panic替代error返回的现代库（如 2024 年后发布的 SDK），都建议提 issue 或换库——这不是 Go 生态的合理实践 - 若你发现某个库文档明确说“输入非法时返回 error”，但它却 panic 了，那大概率是 bug，应报 issue，而不是写 recover 掩盖
真正需要兜底的，是那些你无法控制、又无法替换的遗留库；对新引入的库，第一反应应该是查它的 error 处理契约，而不是默认加 recover。
