默认 gin.recovery() 仅打印 panic 日志并返回空白 500，不记录堆栈、不报警、不分环境，存在安全与可观测性风险；应改用自定义 recovery：捕获 panic → 获取 debug.stack() → 判断 c.writer.written() 避免重复响应 → 记录含 req_id/path 的日志 → 分层报警 → 生产环境响应体不暴露堆栈。
立即进入“夸克ai手把手教你，操作像呼吸一样简单！☜☜☜☜☜点击进入”；
默认的 gin.Recovery() 中间件只打印 panic 日志、返回空白 500，既不记录堆栈，也不通知人——线上出问题时你得靠监控告警“被动发现”，等收到消息，用户早投诉完了。
为什么不能直接用 gin.Recovery()
它只是个“哑巴兜底”：
- 不记录
debug.Stack()，查不到 panic 真正发生在哪里 - 不区分环境，生产环境也把堆栈塞进响应体，有安全风险
- 不触发报警，panic=静默失败，等于没捕获
- 多个中间件里嵌套 panic 时，
c.Writer.Written()检查缺失，可能重复写响应导致 panic
如何让 Recovery 真正“捕获+报警+不崩”
核心是三件事：捕获 panic → 记录可追溯日志 → 推送报警 → 返回友好响应。关键点：
- 用
debug.Stack()获取完整堆栈，存入日志（别只打err.Error()） - 调用报警前先判断是否已写响应：
if c.Writer.Written() { return } - 报警逻辑建议抽成独立函数，比如
notifyPanic(stack, reqID)，对接钉钉/企业微信/ Sentry - 生产环境响应体里绝不能含
stack字段；开发环境可加，但需显式开关
示例片段：
defer func() {
if err := recover(); err != nil {
stack := string(debug.Stack())
reqID := c.GetString("req_id") // 假设你有 trace 中间件注入
log.Printf("[PANIC] req_id=%s, err=%v\n%s", reqID, err, stack)
notifyPanic(stack, reqID) // 这里发钉钉/写 Sentry
if c.Writer.Written() {
return
}
c.JSON(500, gin.H{
"code": 500,
"message": "服务暂时不可用",
})
}
}()
报警时机和内容怎么设计才有效
不是每次 panic 都值得推全员告警——容易疲劳。建议分层：
- 高频 panic（如每分钟 >3 次）→ 触发降级告警（仅值班人）
- 首次出现的新 panic 类型（基于
err.Error()哈希去重）→ 标记为“新异常”，推给负责人 - 带特定关键词的 panic（如
"timeout"、"context deadline"）→ 关联超时链路，自动提工单 - 日志里必须包含：
req_id、path、method、user_agent（如有）、panic 类型
最常被忽略的是 panic 上下文丢失：没传 req_id、没记录请求路径、报警消息里只有“runtime error”，根本没法定位。上线前务必用 curl -X POST /panic-test 手动触发一次，看日志和告警里有没有这些字段。
