Buffalo不适合直接输出静态页面,本质是服务端渲染框架;真正静态页应交由plugins.Static()托管public/目录,而templates/下的.html文件需用c.Render()配合r.HTML()渲染,不可误用c.HTML()。

Buffalo 不适合直接输出“静态页面”——它本质是服务端渲染框架,所谓“静态”,实际是 HTML 模板不依赖动态数据、或由前端构建产物托管。关键不是“怎么静态”,而是“该走模板渲染还是让 Nginx 托管”。
templates/ 下放 .html 文件,用 c.Render() 渲染纯 HTML
这是最接近“静态页面”的做法,但仍是服务端渲染:Buffalo 会读取文件、执行 Plush 解析(哪怕没用 {{ }}),再返回 HTML。
- 文件必须放在
templates/目录下,如templates/about.html - 调用方式必须是
c.Render(200, r.HTML("about")),不是c.HTML()(后者不走模板引擎,变量不会被替换) - 如果页面真的一点动态逻辑都没有,也建议保留
r.HTML("about")调用,避免误用c.HTML()导致响应头错成text/plain - 注意文件扩展名:Buffalo 默认只认
.html和.plush.html,写成about.gohtml或about.html.tmpl都会报template not found
把构建好的前端产物交给 plugins.Static() 托管
这才是真正意义上的“静态页面托管”:Buffalo 不参与 HTML 生成,只当一个带路由能力的文件服务器。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
- 前端构建产物(如 Vue/React 的
dist/)要放进public/目录,不是assets/ - 确保
app.Use(plugins.Static())在app.go中已启用(buffalo new --with-nodejs默认开启) - 访问
/index.html会自动映射到public/index.html;但/默认不自动 fallback 到index.html,需加中间件或改 Nginx 配置 - 如果同时用了模板路由(如
r.GET("/admin", AdminHandler)),要小心路径冲突:/admin会被路由捕获,而/admin/xxx.js若没配好 static 中间件顺序,可能 404
r.Auto() 会干扰静态 HTML 响应格式
如果你在 handler 里写了 r.Auto(c, data),Buffalo 会根据请求头 Accept 自动选 HTML 或 JSON。对纯静态页来说,这反而危险——前端发个 Accept: application/json 请求,就会返回 JSON 错误而不是 HTML。
立即学习“go语言免费学习笔记(深入)”;
- 静态页面 handler 应明确用
c.Render(200, r.HTML("page")),绕过r.Auto() - 若项目是前后端分离架构,建议整个禁用
r.Auto(),所有接口统一用r.JSON(),静态页全交由public/托管 -
r.Auto()默认 fallback 是 HTML,这意味着没有Accept头的 curl 测试请求(如curl -X GET http://localhost:3000/about)也会走 HTML 渲染——看似正常,实则掩盖了 header 依赖问题
最容易被忽略的是:Buffalo 的 public/ 静态托管默认不支持 SPA 的 history 模式 fallback。比如你访问 /dashboard/users,Nginx 可以重写到 index.html,但 Buffalo 不行——它只会返回 404,除非你手动加中间件拦截所有未匹配路由并返回 public/index.html。

















