Buffalo 默认不捕获 panic，需手动添加 defer-recover 中间件并避开 buffalo.Error 干扰；未捕获 panic 会导致前端空响应或超时，因崩溃发生在渲染前且无结构化错误返回。
Buffalo 默认不捕获 panic，必须手动加 defer-recover 中间件，且要避开 buffalo.Error 干扰
为什么直接 panic 会导致前端只看到空响应或超时
Buffalo 不像 Rails 或 Spring Boot 那样内置 panic/recover 全局兜底。一旦发生未捕获的 panic（比如 nil pointer dereference、map write on nil），HTTP handler 会中途崩溃，net/http 底层返回 500，但 response body 往往为空——因为 panic 发生在 c.Render() 或 c.JSON() 之前，框架没机会写内容。
- 日志里能看到 stack trace，但前端收不到结构化错误信息
- 开发时用
buffalo dev还会触发默认的 recovery 中间件，把原始 panic 吞掉、不打印堆栈，进一步掩盖问题 - 真实请求中若 panic 出现在 middleware 链深层（如自定义 auth 中间件），更难定位
app.Use 注册最外层 defer-recover 中间件
必须用 app.Use()，不能用 app.Middleware() —— 后者只作用于路由匹配后的 handler，而 panic 可能发生在路由匹配前（比如中间件初始化阶段）。
- 注册位置：紧贴
app = buffalo.New(...)之后，确保它是第一个被注册、最后一个被执行的中间件 - 中间件内必须手动调用
c.Error(500, ...)，Buffalo 不会自动渲染；不能只return nil或忽略 - 要区分 panic 和
buffalo.Error：后者是框架预期的业务错误（如参数校验失败），recover()捕不到，也不该被吞
示例代码：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
<pre class="brush:php;toolbar:false;">app.Use(func(next buffalo.Handler) buffalo.Handler {
return func(c buffalo.Context) error {
defer func() {
if r := recover(); r != nil {
// 跳过 buffalo.Error，避免把 400 错误也变成 500
if _, ok := r.(buffalo.Error); ok {
return
}
c.Log().Errorf("panic recovered: %v", r)
debug.PrintStack()
c.Error(500, fmt.Errorf("internal server error"))
}
}()
return next(c)
}
})
线上必须记录 panic 上下文，不能只返回 500
单纯 c.Error(500, ...) 对排查毫无帮助。线上环境 panic 必须附带请求上下文，否则无法复现。
- 用
c.Request().URL.Path、c.Request().Method、c.Request().RemoteAddr补充关键字段 -
debug.PrintStack()输出到 stderr 是最简方式；生产建议接入结构化日志（如zerolog），把 panic 作为 error level 事件打出去 - 注意：recover 后不要继续执行原 handler，response writer 可能已部分写入，二次写入会 panic
调试时怎么看到真实 panic 堆栈
buffalo dev 默认启用 recovery 中间件，会屏蔽原始 panic。要快速验证中间件是否生效、或定位具体哪行 panic：
- 临时改用
go run main.go启动，绕过所有 Buffalo 封装 - 或在
app.go中注释掉middleware.Recovery的注册行（如果项目显式加了） - 加编译参数提速：
go run -gcflags="-l" main.go，跳过内联优化，缩短重启时间
真正难处理的不是 panic 本身，而是 panic 发生后 response writer 状态不可控、日志上下文缺失、以及和 buffalo.Error 的语义混淆——这三点漏掉任一，线上问题就只能靠猜。
