Go JSON 序列化优化：字段裁剪、Buffer 复用与兼容性

JSON 序列化常常出现在 API 热路径上。很多优化团队第一反应是换更快的库，但在此之前，字段裁剪、结构设计、buffer 复用和响应大小控制通常收益更稳定。

先看响应体大小

如果响应字段过多、嵌套太深或包含大数组，换库只能优化编码过程，不能减少网络传输和客户端解析成本。先裁剪字段和分页，往往更有效。

复用 buffer 要小心

可以配合 sync.Pool 复用 bytes.Buffer，但必须在 Put 前 Reset，并且不要把 buffer 引用泄露到响应之后。

替代库要评估兼容性

更快的 JSON 库可能在标签、数字精度、HTML escape、omitempty 行为上与标准库有差异。替换前必须有兼容性测试。

生产场景

适用于 BFF 聚合接口、列表页接口、报表 API 和高 QPS JSON 服务。

关键指标

• encode CPU 占比
• 响应体大小和压缩比
• 序列化 B/op 与 allocs/op

常见误区

• 不裁剪字段直接换库
• 复用 buffer 后发生数据串扰
• 忽略 JSON 行为兼容性

代码示例

buf := bufferPool.Get().(*bytes.Buffer)
buf.Reset()
defer bufferPool.Put(buf)
err := json.NewEncoder(buf).Encode(resp)

上线检查

• 优化前后必须保留同一条件下的 benchmark 或 profile。
• 至少观察 P95/P99、错误率、CPU、内存和 GC 指标。
• 如果改动影响热路径，必须准备灰度和回滚方案。