Buffalo 默认不设置静态资源 Cache-Control 头，需手动包装 http.FileServer 并在 ServeHTTP 前设置 header；示例中根据文件扩展名分别设置 max-age=31536000 或 86400。
Buffalo 默认不自动设置静态资源的 Cache-Control 头，哪怕你用 app.Static("/assets", "./public/assets") 注册了路径，浏览器仍可能每次请求都走完整 HTTP 流程（200 或 304 取决于 ETag），这不是缓存失效，而是压根没设缓存策略。
Buffalo 1.x 的 static handler 不支持 max-age 配置
Buffalo 内置的 app.Static() 底层调用的是 http.FileServer，而它本身不提供 Cache-Control 设置入口。你不能像 Express 那样传个 { maxAge: 31536000 } 进去 —— Buffalo 没这个参数，也没暴露 http.ServeFile 的包装逻辑供你 hook。
常见错误现象：
- 部署后发现 JS/CSS 总是重新下载，DevTools Network 标签里
Size列显示from network而非from disk cache - 用
curl -I http://localhost:3000/assets/main.css查看响应头，没有Cache-Control或Expires
手动 wrap Static handler 是唯一可靠方式
必须自己写一个中间件或包装 handler，在返回前注入缓存头。关键点是：不能直接改 app.Static 返回的 handler（它不可变），而要拦截其响应流。
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
实操建议：
- 在
app.go的路由注册阶段，用http.HandlerFunc包一层原始http.FileServer实例 - 用
http.StripPrefix剥离路径前缀后，再调用fileServer.ServeHTTP - 在包装函数里，对匹配到的静态文件路径（如
.js、.css、.png）显式写入w.Header().Set("Cache-Control", "public, max-age=31536000") - 注意顺序：必须在
fileServer.ServeHTTP**之前** 设置 header，否则会 panic（header already written）
示例片段：
fs := http.FileServer(http.Dir("./public/assets"))
app.Handler("/assets/", http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
ext := path.Ext(r.URL.Path)
switch ext {
case ".js", ".css", ".png", ".jpg", ".woff2":
w.Header().Set("Cache-Control", "public, max-age=31536000")
default:
w.Header().Set("Cache-Control", "public, max-age=86400")
}
http.StripPrefix("/assets/", fs).ServeHTTP(w, r)
}))
别碰 buffalo-plugins/static 或第三方 middleware
社区有零星的 buffalo-static-cache 类插件，但它们大多基于旧版 Buffalo（buffalo.MiddlewareFunc 接口。2026 年主流用的是 Buffalo 1.25+，其中间件模型已改为标准 http.Handler 链式调用，强行接入老插件会导致：
- 编译失败（类型不匹配，
buffalo.Context已移除） - 缓存头被后续中间件（如
gzip）覆盖 - 对目录索引请求（如
/assets/）也加了 long-term 缓存，导致刷新后看不到新文件列表
真正起作用的只有你自己控制的 handler 包装逻辑 —— 它绕过了 Buffalo 的抽象层，直触 net/http 原语，也正因如此，它稳定、可测、无版本锁死风险。最容易被忽略的一点是：path.Ext() 对 URL 路径的提取必须干净，比如 /assets/v1/main.js?ts=123 里的 ?ts=123 会被 path.Ext 错误识别为扩展名，应先用 strings.Split(r.URL.Path, "?")[0] 截断查询参数。
