Buffalo默认不自动响应HEAD请求，需显式注册HEAD路由并避免调用c.Render；正确做法是使用c.Render(200, nil)手动设置Header且不输出响应体。
Buffalo路由默认不自动响应HEAD请求
Buffalo的GET路由不会自动复用处理函数响应HEAD请求，这点和标准HTTP规范一致：HEAD应返回与对应GET相同的响应头，但不带响应体。Buffalo不会帮你隐式拦截或转发，直接发HEAD到一个只注册了GET的路由，会返回405 Method Not Allowed。
显式注册HEAD路由是唯一可靠方式
必须手动为需要支持HEAD的端点添加HEAD方法注册，且推荐复用同一处理函数——这样能保证Header逻辑完全一致，避免GET里加了ETag而HEAD没加导致缓存行为不一致。
- 在
app.go中用app.Head("/api/users", UsersHandler)显式注册 - 不要写
app.Get("/api/users", UsersHandler)再指望它“顺便”处理HEAD - 如果用资源路由（
app.Resource），它默认不生成HEAD路由，需额外调用resource.Head("show", ShowHandler)
HEAD处理函数里不能调c.Render
HEAD请求禁止返回响应体，但c.Render默认会写入body（哪怕内容为空），这违反HTTP语义，某些代理或CDN可能因此拒绝或篡改响应。正确做法是手动设置状态码和Header，跳过渲染：
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
func UsersHeadHandler(c buffalo.Context) error {
c.Response().Header().Set("Content-Type", "application/json")
c.Response().Header().Set("X-Total-Count", "127")
// 不要调 c.Render(...)！
return c.Render(200, nil) // 这里 nil 是关键：buffalo 会跳过 body 写入
}
注意：c.Render(200, nil)是Buffalo中安全终止HEAD响应的惯用写法；传空结构体或map[string]any{}仍可能触发JSON序列化，造成意外body输出。
测试HEAD是否生效要绕过浏览器限制
浏览器地址栏或普通表单无法发HEAD，开发者工具Network面板里也看不到HEAD预检之外的真实HEAD请求。必须用curl或Postman验证：
-
curl -I http://localhost:3000/api/users（-I即发送HEAD并只显示Header） - 检查返回里是否有你手动设置的
X-Total-Count等自定义Header - 确认响应状态是200而非405，且没有
Content-Length: > 0
容易忽略的是：中间件（如cors、gzip）可能对HEAD请求做特殊处理，比如gzip中间件默认跳过HEAD，但如果你自己写了Header注入中间件，得确认它对c.Request().Method == "HEAD"做了兼容分支。
