buffalo中c.request().body不自动解析嵌套json，需手动用json.newdecoder解码并严格匹配结构体字段名、类型及首字母大写；map[string]interface{}易panic，不推荐生产使用。
Buffalo 中 c.Request().Body 默认不自动解析嵌套 JSON
Buffalo 的 c.Request().Body 是原始字节流，不会像 Gin 的 c.ShouldBindJSON() 那样自动递归解码嵌套结构。如果你直接用 json.Unmarshal 读取，但结构体字段类型与 JSON 层级不匹配（比如期望 map[string]interface{} 却声明为 string），就会静默失败或返回空值 —— 这是最常见的“解析成功但字段为空”现象。
必须显式定义匹配的 Go 结构体，且字段名要对齐 JSON key
Buffalo 不支持运行时动态 schema 推断，所有嵌套层级都得提前用 struct 描述。例如，收到如下 JSON：
{"user":{"profile":{"name":"Alice","tags":["admin","dev"]},"settings":{"theme":"dark","notify":true}}}
你需要写：
type UserRequest struct {
User struct {
Profile struct {
Name string `json:"name"`
Tags []string `json:"tags"`
} `json:"profile"`
Settings struct {
Theme string `json:"theme"`
Notify bool `json:"notify"`
} `json:"settings"`
} `json:"user"`
}
然后在 handler 中手动解码：
详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
func MyHandler(c buffalo.Context) error {
var req UserRequest
if err := json.NewDecoder(c.Request().Body).Decode(&req); err != nil {
return c.Error(400, err)
}
// 后续使用 req.User.Profile.Name 等
}
- 字段首字母必须大写（否则
json包无法导出） -
json:tag 必须精确匹配请求中的 key 名（含大小写、下划线） - 嵌套过深时，建议把内层结构单独定义为命名 type，提高可读性和复用性
用 map[string]interface{} 临时绕过结构体定义？小心 panic
虽然可以这样读：
var raw map[string]interface{}
json.NewDecoder(c.Request().Body).Decode(&raw)
但后续访问 raw["user"].(map[string]interface{})["profile"] 时，每层类型断言都可能 panic。Buffalo 默认不 recover 这类 panic，会导致整个请求 500。更稳妥的做法是逐层检查类型：
if user, ok := raw["user"].(map[string]interface{}); ok {
if profile, ok := user["profile"].(map[string]interface{}); ok {
if name, ok := profile["name"].(string); ok {
// 安全使用 name
}
}
}
- 这种写法适合调试或极简原型，不适合生产环境
- 一旦 JSON 字段缺失或类型错配（比如
"tags"实际是null而不是数组），.(type)就会 panic - 没有编译期类型保障，重构时极易出错
别指望 Buffalo 中间件自动做这件事
Buffalo 没有类似 Gin 的 ShouldBindJSON 或 Echo 的 Bind 中间件。它的 c.Param() 只处理 URL 参数，c.FormValue() 只处理表单，对 JSON body 完全不干预。你必须自己调用 json.NewDecoder，且注意：c.Request().Body 只能读一次 —— 如果你在中间件里提前读了又没重放，handler 里再读就是空的。
- 不要在自定义中间件里无条件
io.ReadAll(c.Request().Body) - 如果需要预处理 JSON，得用
http.MaxBytesReader控制体积，并把 bytes 重新包装成io.NopCloser放回c.Request().Body - 多数真实项目中，直接在 handler 里解码反而更清晰、更可控
真正容易被忽略的是：嵌套 JSON 的字段名拼写错误、类型不一致、未导出字段这三类问题，不会报错，只会让字段保持零值 —— 调试时得打印 fmt.Printf("%+v", req) 看实际解码结果，而不是只查逻辑。
