Go 的 json.Marshal 默认性能不差,但高频、大数据量或低延迟场景下会成瓶颈,因其基于反射+interface{}动态推导,每次调用需字段遍历、类型检查、标签解析并频繁分配小对象;jsoniter可零修改接入提升1.5–3倍,手写MarshalJSON或代码生成(easyjson/go-json)可进一步优化。

Go 的 json.Marshal 默认性能不差,但高频、大数据量或低延迟场景下,它确实会成为瓶颈——尤其当结构体嵌套深、字段多、含指针或接口时。直接换库或改写序列化逻辑前,先确认是不是真的被它拖慢了:用 pprof 看 CPU profile 里 encoding/json.(*encodeState).marshal 是否排前三。
为什么默认 json.Marshal 慢?
它基于反射 + interface{} 动态类型推导,每次调用都要做字段遍历、类型检查、标签解析(如 json:"name,omitempty"),还频繁分配小对象([]byte、临时 map/slice)。对固定结构体来说,这些开销完全可预编译消除。
- 反射调用比直接字段访问慢 3–10 倍(视字段数而定)
- 每个
json.Marshal至少触发 1–2 次内存分配,GC 压力随 QPS 上升明显 - 不支持复用
bytes.Buffer或预分配目标切片,无法避免扩容拷贝
jsoniter 替代:零修改接入,提升 1.5–3 倍
jsoniter 是最平滑的替代方案,API 完全兼容标准库,只需替换 import 和初始化一次配置即可生效。它通过代码生成+缓存反射信息+减少接口断言来提速。
import "github.com/json-iterator/go" var json = jsoniter.ConfigCompatibleWithStandardLibrary // 之后所有调用和标准库一致: data, err := json.Marshal(user) err = json.Unmarshal(data, &user)
- 首次调用仍需反射建缓存,后续同类型调用几乎无反射开销
- 支持
jsoniter.RegisterTypeEncoder手动注册自定义 encoder,绕过反射(适合核心模型) - 注意:启用
jsoniter.UseIteratorMode()后不兼容某些自定义MarshalJSON实现,需实测验证
手写 MarshalJSON:极致控制,但维护成本高
对稳定、字段少的核心结构体(如 User、Order),手动实现 MarshalJSON 能去掉全部反射,复用 bytes.Buffer,甚至跳过空值判断逻辑。
立即学习“go语言免费学习笔记(深入)”;
func (u User) MarshalJSON() ([]byte, error) {
var buf bytes.Buffer
buf.Grow(256) // 预估长度,避免多次扩容
buf.WriteByte('{')
if u.ID != 0 {
buf.WriteString(`"id":`)
buf.WriteString(strconv.FormatInt(int64(u.ID), 10))
buf.WriteByte(',')
}
if u.Name != "" {
buf.WriteString(`"name":"`)
buf.WriteString(u.Name)
buf.WriteByte('"')
}
buf.WriteByte('}')
return buf.Bytes(), nil
}
- 必须严格按 JSON 语法拼接,引号、逗号、转义(如
"→\")全得自己处理 - 字段顺序、
omitempty行为、嵌套结构、time.Time格式都得显式编码,易出错 - 一旦结构体加字段,必须同步更新该函数,CI 中建议加单元测试校验输出与标准库一致
生成式方案:easyjson 或 go-json
如果能接受 build 时代码生成,easyjson(老但稳定)或 go-json(新、更激进优化)是折中选择:无需手写,无运行时反射,性能接近手写,且保持结构体变更自动同步。
-
easyjson生成MarshalJSON/UnmarshalJSON方法,需在 struct 上加//easyjson:json注释 -
go-json不侵入源码,通过go:generate扫描包内 struct,生成独立文件,但暂不支持嵌套 interface{} 字段 - 两者都不支持动态字段名(如
map[string]interface{}),这类仍要走标准库或jsoniter
真正卡点往往不在“用不用更快的库”,而在于是否把 json.Marshal 放进了 hot path 循环里、是否反复序列化同一份数据、是否忽略了 sync.Pool 复用 bytes.Buffer。先压测定位,再选方案——多数服务升级 jsoniter 就够了;只有极少数核心 DTO 值得投入手写或生成。











