buffalo 中 c.request().body 只能读取一次，因底层为 io.readcloser；应优先用 c.body()（自动缓存解析）或 c.bind()（完整反射绑定），手动读取需用 bytes.newreader 重置，且须确保 content-type 正确、结构体字段导出并带 json tag。
Buffalo 中 c.Request().Body 不能直接多次读取
Buffalo 基于 Go 的 net/http，而原生的 http.Request.Body 是一次性流（io.ReadCloser），一旦被读取（比如解析 JSON），后续再调用 c.Request().Body 就会返回空或 EOF。很多新手在中间件里手动读了一次 body，又在 handler 里调用 c.Param() 或 c.Body()，结果拿到空数据。
正确做法是：让 Buffalo 统一处理请求体解析，避免手动读取原始 Body。
- 优先使用
c.Param()（适用于 URL 查询参数）或c.Body()（Buffalo 封装的自动解析方法） - 如果必须手动解析，先用
io.ReadAll(c.Request().Body)读一次，然后用bytes.NewReader()重置为可复用的io.ReadCloser，再塞回c.Request().Body - Buffalo 的
c.Body()内部已做缓存，它会把首次解析结果存在上下文里，后续调用直接返回缓存值
c.Body() 默认只解析 application/json 和 application/x-www-form-urlencoded
如果你发的是 application/json 请求，c.Body() 能直接返回 map[string]interface{} 或结构体指针；但如果是 text/plain、application/octet-stream 或自定义 content-type，c.Body() 会返回 nil 或报错 Unsupported media type。
常见场景：前端用 fetch 发送纯 JSON 字符串但没设 header，或后端对接第三方服务传了非标准类型。
- 确保请求 header 包含
Content-Type: application/json - 若需支持其他类型，得自己注册解析器，例如在
app.go初始化时调用buffalo.RequestParser.Register("text/plain", yourPlainParser) - 临时绕过：用
io.ReadAll(c.Request().Body)手动读原始字节，再用json.Unmarshal解析
绑定到结构体时字段名不匹配导致解析为空
Buffalo 使用 Go 标准库的 json 包解析，依赖结构体字段的 json tag。如果字段没加 tag，且首字母小写（未导出），JSON 字段就无法写入，最终结构体字段保持零值。
详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
比如前端传 {"user_name":"alice"}，但结构体写成：
type UserInput struct {
UserName string `json:"user_name"`
}
这是对的；但如果漏掉 tag，或写成 userName（小写开头），解析后 UserName 就是空字符串。
- 所有待绑定的字段必须首字母大写（导出）
- 显式声明
jsontag，尤其当 JSON key 含下划线、大小写不一致时 - 用
c.Bind(&u)替代c.Body()可获得更明确的错误反馈（如类型不匹配、必填字段缺失）
嵌套 JSON 或数组解析失败的典型表现
前端传 {"items":[{"id":1},{"id":2}]}，你定义结构体：
type Req struct {
Items []Item `json:"items"`
}
type Item struct {
ID int `json:"id"`
}
看起来没问题，但 Buffalo 的 c.Body() 默认只做浅层解析——它不会自动实例化嵌套结构体切片元素，除非你显式调用 c.Bind() 并确保类型完整。
-
c.Body()返回的是map[string]interface{}，嵌套部分仍是interface{}，需要手动类型断言 - 推荐统一用
c.Bind(&req)，它会触发完整结构体反射绑定，包括 slice 和嵌套 struct - 如果结构体字段是
*Item（指针），且 JSON 中对应字段为null，绑定后该字段为nil，注意空指针 panic 风险
Buffalo 对 JSON 的处理逻辑藏在 c.Body() 和 c.Bind() 两层封装里，真正容易出问题的不是语法，而是对“谁在什么时候解析、解析几层、缓存是否生效”的误判。调试时优先打日志看 c.Request().Header.Get("Content-Type") 和 c.Request().ContentLength，比盲目改结构体 tag 更快定位根因。
