Buffalo框架默认不内置RESTful路由约定，其app.Resource()仅形似RESTful，需手动配对HTTP方法与处理逻辑，纯API开发应显式声明路由并统一返回JSON。
Buffalo框架默认不内置RESTful路由约定
Buffalo 的 app.Resource() 确实会生成类似 RESTful 的路由，但它只是“形似”——不自动绑定 HTTP 方法到标准动作（如 GET /users → Index），也不强制控制器方法签名或响应格式。你得手动配对方法、路径和处理逻辑。
真正实现 RESTful API 的关键，在于主动用 app.GET()、app.POST() 等显式声明，并统一返回 JSON，而不是依赖 Resource() 自动生成的 HTML 模板逻辑。
-
app.Resource("users", UsersResource{})默认渲染 HTML，若未覆盖Respond方法，会尝试查找users/index.html模板，导致 404 或意外 HTML 响应 - 要走纯 API 路线，应跳过
Resource()，直接写app.GET("/api/users", UsersList)这类显式路由 - 所有 handler 必须调用
c.JSON()或c.Error()，避免c.Render()（它走模板，不适合 API）
如何让 handler 返回标准 JSON 响应结构
Buffalo 没有内置的 API 响应包装器，但你可以用一个简单函数统一格式，比如：
func JSONSuccess(c buffalo.Context, data interface{}, statusCode int) error {
return c.JSON(statusCode, map[string]interface{}{
"success": true,
"data": data,
"error": nil,
})
}
func JSONError(c buffalo.Context, err error, statusCode int) error {
return c.JSON(statusCode, map[string]interface{}{
"success": false,
"data": nil,
"error": err.Error(),
})
}
这样能避免每个 handler 里重复写 map[string]interface{}，也方便前端统一解析 data 字段。
- 别直接
c.JSON(200, user)—— 缺少状态标识，前端难做通用错误处理 - 注意
statusCode：创建资源用201，更新成功用200，删除成功也用200或204（无 body） - 如果用了
github.com/gobuffalo/pop/v6查询，记得先检查err != nil再调用JSONSuccess，否则 panic
如何处理请求体解析与验证（尤其是 POST/PUT）
Buffalo 的 c.Bind() 可以解析 JSON 请求体，但默认不校验字段，也不区分空字符串和缺失字段。常见坑是："" 被当成有效值入库，而实际业务要求非空。
推荐组合使用：
- 定义 struct 时加
json:tag 控制字段映射，例如Name string `json:"name" db:"name"` - 用
github.com/go-playground/validator/v10做结构体校验，配合c.Bind()后立即调用Validate() - 对 PUT/PATCH，建议用两个 struct：一个用于接收输入（带
validatetag），一个用于 DB 更新（只含允许修改的字段） - 别忘了设置请求头：
Content-Type: application/json，否则c.Bind()会静默失败并返回零值
示例片段：
type UserCreateInput struct {
Name string `json:"name" validate:"required,min=2"`
Email string `json:"email" validate:"required,email"`
}
func CreateUser(c buffalo.Context) error {
var input UserCreateInput
if err := c.Bind(&input); err != nil {
return JSONError(c, err, 400)
}
if err := validate.Struct(input); err != nil {
return JSONError(c, err, 400)
}
// ... 创建逻辑
}
为什么中间件里不能用 c.Render() 且必须提前终止链
API 场景下，认证或权限中间件（如 JWT 验证）一旦失败，必须立刻返回 JSON 错误并中断后续 handler 执行。如果只写 c.Error(401, err) 却没 return，控制流会继续往下走，最终可能触发 c.JSON() 或更糟的 c.Render()，导致响应体混乱或 panic。
- 所有中间件中，凡调用
c.JSON()、c.Error()、c.Response().WriteHeader()后，必须紧跟return - 不要在中间件里调用
c.Render()—— 它依赖模板引擎，API 不需要，且会干扰后续 JSON 输出 - 可复用
github.com/gobuffalo/mw-forcessl这类轻量中间件，但自定义鉴权中间件务必检查c.Request().Header.Get("Authorization")并手动解析 token
复杂点往往不在路由或响应，而在状态一致性：比如 DELETE 成功后是否该返回被删资源快照？404 时要不要区分“资源不存在”和“无权限访问”？这些边界得靠 handler 里细粒度判断，Buffalo 不替你决定。
