必须禁用模板系统（app.templates = nil）并显式调用c.render(200, r.json(data))，不可用c.json()（buffalo无此方法），否则默认走html渲染导致404或异常响应。
Buffalo 里怎么让接口返回 JSON 而不是 HTML
默认用 app.Resource() 或没配响应格式的 handler，会走 HTML 渲染流程，找不到模板就报 404 或吐出奇怪的 HTML —— 这不是你想要的 API 行为。必须显式切断模板链，强制返回 JSON。
关键操作只有两步：禁用模板系统 + 显式调用 c.Render() 配 r.JSON()：
-
app.Templates = nil放在app.go初始化位置（比如app = buffalo.New(buffalo.Options{...})后面），否则c.Render()内部仍会尝试加载 HTML 模板 - 所有 API handler 必须用
c.Render(status, r.JSON(data))，不能只写return c.JSON(data)（Buffalo 没这个方法） - 如果用了
middleware.PopTransaction，确保它在app.Use()中注册顺序靠前，否则事务可能没提交就返回了
如何根据 Accept 头自动切换 JSON/XML/HTML 响应
客户端明确声明要什么格式时，硬写死 r.JSON() 就不够灵活了。Buffalo 不自动解析 Accept，得自己判断并分发渲染器。
典型写法是提取头、匹配字符串、分支返回：
func UserHandler(c buffalo.Context) error {
accept := c.Request().Header.Get("Accept")
switch {
case strings.Contains(accept, "application/json"):
return c.Render(200, r.JSON(map[string]string{"name": "alice"}))
case strings.Contains(accept, "application/xml"):
return c.Render(200, r.XML(map[string]string{"name": "alice"}))
default:
return c.Render(200, r.HTML(map[string]string{"name": "alice"}))
}
}
-
strings.Contains()足够应付大多数情况，不用正则；注意大小写不敏感，但Accept值本身可能带空格或参数（如application/json; charset=utf-8），所以用Contains比==更鲁棒 - XML 渲染需确保结构体字段有
xml:tag，否则输出空标签 - HTML 分支慎用——纯 API 服务建议直接返回 406 Not Acceptable，而不是 fallback 到 HTML
第三方调用失败时怎么返回统一错误结构
下游挂了、超时、返回 502，你却返回了 template: not found 错误？这是因为没关模板系统，c.Render() 在找不到对应格式渲染器时会降级尝试 HTML 模板。
Buffalo框架 1.0.1
下载
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
正确做法是：提前构造错误响应，绕过任何模板逻辑：
- 确保
app.Templates = nil已设置，否则r.JSON()可能被中间件劫持 - 用
c.Status(code).Render(code, r.JSON(errMap))，比如c.Status(502).Render(502, r.JSON(map[string]string{"error": "upstream unavailable"})) - 不要依赖
app.ErrorHandler处理第三方异常——它只捕获框架内部 panic，不接管你手动写的c.Render() - 如果用了自定义错误中间件，检查它是否在
c.Render()前就修改了 status code，导致状态码和 body 不一致
返回数据时怎么避免 context 被提前 cancel 导致 panic
在 handler 里启 goroutine 异步处理（比如发日志、调下游），然后直接 return c.Render()，结果子 goroutine 里访问 c.Request() 或 c.Session() 报 panic？因为 buffalo.Context 生命周期只到 handler 返回为止。
真正安全的做法是：只传原始值，不传 c：
- 需要用户 ID 就提前取：
userID := c.Session().Get("user_id")，再作为参数传进 goroutine - 需要 trace ID 就从 header 提前读：
traceID := c.Request().Header.Get("X-Request-ID") - 绝对不要把
c整个传进 goroutine，也不要在 goroutine 里调c.Render()或c.Redirect() - 如果必须等异步结果才返回，那就别开 goroutine，改用
sync.WaitGroup或select等待，保持 handler 同步执行
最常被忽略的是 app.Templates = nil 这一行——它不写，后面所有 JSON 渲染都可能被模板系统干扰；还有就是以为 c.Context 能跨 goroutine 安全使用，结果在后台任务里访问 session 时突然 panic。
