buffalo中c.json返回空响应的主因是结构体字段未导出（首字母小写），导致encoding/json无法访问；需确保字段首字母大写、正确使用json:"name"标签，避免nil切片或循环引用，并显式调用c.json(200, data)而非直接return struct。
Buffalo 中用 JSON 方法返回结构化数据
Buffalo 默认不自动序列化结构体为 JSON，必须显式调用 c.JSON，否则会触发模板渲染或 404。它内部使用 encoding/json，所以字段需导出（首字母大写），且不能有循环引用。
常见错误是直接 return struct 或 map 而没包一层 c.JSON，结果返回空响应或 panic。
c.JSON(200, map[string]interface{}{"ok": true, "data": users})- 若返回自定义结构体，确保字段带
json:tag，例如type User { Name string `json:"name"` } - 状态码非 200 时，务必传入对应数字，
c.JSON(400, map[string]string{"error": "bad request"})
处理 nil 值和空切片的注意事项
Buffalo 的 c.JSON 对 nil slice 返回 null，而非 []；对 nil struct 指针也返回 null。这在前端解析时容易出错，尤其 TypeScript 类型校验严格时。
典型场景：数据库查不到记录，users := []User{} 是空切片，但 users := []*User(nil) 就是 null。
Comprehensive Three.js 3D graphics reference
下载
详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
- 统一用
make([]User, 0)初始化空切片，避免nil - 返回指针字段前先判空：
if u == nil { c.JSON(404, map[string]string{"error": "not found"}); return } - 如需强制转空数组，可封装一层：
c.JSON(200, struct{ Data []User }{Data: users})
启用 gzip 压缩和设置 Content-Type
Buffalo 默认不开启响应压缩，大体积 JSON 接口（比如列表页）可能拖慢移动端加载。Content-Type 虽然 c.JSON 会设为 application/json; charset=utf-8，但某些代理或网关会覆盖它。
压缩需手动注册中间件，且只对 >=1KB 的响应生效，太小的 JSON 反而增加 CPU 开销。
- 在
app.go的app.Use(middleware.PopulateRequestID())后加：app.Use(middleware.Gzip()) - 若需强制指定类型（比如兼容旧客户端），可在
c.JSON后追加：c.Response().Header().Set("Content-Type", "application/json") - Gzip 中间件默认只压缩 text/html、application/json 等 MIME，无需额外配置
调试 JSON 接口时怎么快速定位问题
最常遇到的是字段没出来、时间格式不对、中文乱码，或者 CORS 阻止了请求——但浏览器控制台只显示 “Failed to fetch”，看不出后端真实错误。
建议在 handler 开头加日志，用 log.Printf 打印原始数据，再用 c.JSON；同时开 buffalo dev 看实时 stderr 输出。
- 检查时间字段：默认输出 RFC3339，如需 Unix 时间戳，改用
json:"created_at,omitempty,string"+ 自定义 MarshalJSON - 中文不乱码的前提是 Go 源文件本身是 UTF-8 编码，且没用
fmt.Sprintf("%s", ...)拼接 JSON 字符串 - CORS 报错不是 JSON 问题，而是响应头缺失；用
middleware.CORS()并确认AllowOrigins配置正确
c.JSON 看似简单，但结构体嵌套深度、time.Time 处理、nil 安全、gzip 触发阈值这些点，稍不注意就会在联调或压测时暴露。
