buffalo generate resource users name:string email:string 会生成含7个handler的actions/users.go、RESTful路由、HTML模板、models/user.go及迁移文件，并自动挂载session、CSRF、DB事务等中间件，但这些对纯API场景是冗余干扰。
buffalo.Resource 生成器确实能快速 scaffold 一个带完整 CRUD 路由和模板的资源，但它的默认行为在现代前后端分离或 API 场景中极易踩坑，不是“开箱即用”，而是“开箱即修”。
buffalo generate resource 会生成什么
运行 buffalo generate resource users name:string email:string 后，它会：
- 创建
actions/users.go，含Index、Show、New、Create、Edit、Update、Destroy七个 handler - 自动生成 RESTful 路由（
GET /users、POST /users等） - 生成
templates/users/下全套 HTML 模板（含表单、列表、flash 提示） - 创建
models/user.go和迁移文件（依赖popORM） - 自动挂载
session.Middleware、csrf.Middleware、pop.Transaction等中间件
这些对传统服务端渲染应用是便利的，但如果你只想要 JSON API 或想接入前端框架（React/Vue），它们就成了干扰源。
为什么 app.Resource 不适合纯 API 场景
app.Resource 的设计目标是 MVC 全栈闭环，不是轻量 API 层。常见问题包括：
-
app.JSON()返回时可能被模板中间件拦截，报错template: "users/index.html" is undefined -
csrf.Middleware强制要求 POST/PUT/DELETE 带 token，前端调用失败 -
session.Middleware会尝试读写 session cookie，而 API 通常无状态 - 所有 handler 默认返回
html内容类型，Content-Type: application/json需手动覆盖
你不能只删模板文件就完事——中间件链仍在生效，请求仍会经过无用的 session 初始化、CSRF 校验、DB 事务开启等步骤。
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
如何安全地用 Resource 生成 API 骨架（不推荐但可行）
如果你已用 Buffalo 启动项目，又想最小改动复用 generate resource 的路由结构，必须显式剥离冗余层：
- 在
app.go中禁用模板和会话：app.Templates = nil app.Use(session.Middleware()) // → 改为注释掉这行，或明确跳过：app.Use(onlyJSONMiddleware)
- 删除或重写
actions/users.go中所有c.Render调用，统一改用c.JSON - 手动移除 CSRF 中间件：检查
app.Use(csrf.Middleware)是否存在，删掉 - 移除 DB 事务中间件：确保没有
app.Use(pop.Transaction(app.DB)) - 若不需要模型，删掉
models/user.go和对应 migration，否则启动时报错找不到 DB
注意：buffalo dev 仍会尝试加载 templates/ 目录，哪怕你没用它——建议顺手删掉整个 templates/users/ 目录，避免热重载冲突。
更现实的选择：别用 Resource，直接手写 API 路由
Buffalo 的 app.GET/app.POST 是完全可用的，且更可控：
-
app.POST("/api/users", UsersCreate) -
app.GET("/api/users", UsersList) - handler 函数里只做
c.JSON(200, data)，不碰c.Render、c.Session()、c.DB - 这样绕开
Resource的约定，反而更轻、更易测试、更容易加 context timeout 或下游并发控制
真正难的从来不是生成 CRUD，而是让每个接口满足字段裁剪、错误码归一、鉴权透传、超时熔断这些 BFF 层该干的事——而 buffalo.Resource 对这些毫无准备。
复杂点在于：你得接受 Buffalo 的定位本质是「全栈 MVC」，不是「API 工具箱」；强行把它当 CRUD 生成器用，等于开着拖拉机跑高速——能动，但每一步都在对抗设计初衷。
