json.Marshal在HTTP handler中易成瓶颈，因触发两次内存拷贝、反射开销大、GC压力高；推荐用json.Encoder、easyjson/fastjson或io.Pipe流式处理优化。
为什么 json.Marshal 在 HTTP handler 中容易成为瓶颈
直接调用 json.Marshal 再写入 http.ResponseWriter 看似简洁，但会触发两次内存拷贝：一次是序列化到临时 []byte，另一次是通过 Write 复制到网络缓冲区。高并发下 GC 压力和分配开销明显上升，尤其当结构体嵌套深、字段多时，json.Marshal 的反射路径开销不可忽略。
- 避免在 handler 内反复创建大结构体实例；优先复用或使用指针传参
- 禁用
json:",omitempty"在高频字段上——它强制 runtime 检查零值，拖慢序列化 - 若响应体固定且简单（如状态码+消息），改用预格式化字符串 +
w.Header().Set("Content-Type", "application/json")直接w.Write
用 json.Encoder 替代 json.Marshal 节省内存
json.Encoder 直接写入 io.Writer（比如 http.ResponseWriter），跳过中间字节切片分配。它不缓存整个 JSON 字符串，适合流式输出或大响应体场景，GC 友好且延迟更稳定。
func handler(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Content-Type", "application/json")
enc := json.NewEncoder(w)
err := enc.Encode(struct{ Name string }{Name: "alice"})
if err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
return
}
}
- 注意：
json.Encoder会在每次Encode后自动换行（RFC 7159 允许），多个Encode调用会产生合法但非标准的多行 JSON；单次响应请确保只调用一次 - 无法提前设置
Content-Length（因为长度未知），对某些代理或监控工具可能造成影响 - 若需错误后中断写入，必须检查
enc.Encode返回的err—— 此时响应头已发送，无法再调用http.Error
用 fastjson 或 easyjson 替代标准库提升吞吐
标准 encoding/json 依赖反射，而 fastjson（无须代码生成）和 easyjson（生成静态 marshal/unmarshal 方法）可减少 30%~60% 序列化耗时，尤其在百万级 QPS 场景下差异显著。
-
fastjson适用于动态结构或 JSON Schema 不固定的情况，但要求手动处理类型断言，易出错 -
easyjson需运行easyjson -all xxx.go生成xxx_easyjson.go，之后用MyStruct.MarshalJSON()替代json.Marshal，零反射、零分配（针对目标 struct） - 二者都不兼容
json.Marshaler接口，原有自定义序列化逻辑需重写
HTTP 层绕过序列化：用 io.Pipe 实现异步 JSON 流
当数据源本身是流式（如数据库 cursor、文件读取、外部 API 转发），且结构体字段可逐步确定时，可用 io.Pipe 将序列化与 HTTP 写入解耦，避免阻塞 handler goroutine。
立即学习“go语言免费学习笔记（深入）”；
func streamingHandler(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Content-Type", "application/json")
w.Header().Set("Transfer-Encoding", "chunked")
pr, pw := io.Pipe()
defer pw.Close()
go func() {
defer pw.Close()
enc := json.NewEncoder(pw)
for _, item := range generateItems() { // 模拟流式数据源
if err := enc.Encode(item); err != nil {
pw.CloseWithError(err)
return
}
}
}()
io.Copy(w, pr)
}
- 必须显式设置
Transfer-Encoding: chunked或禁用Content-Length，否则net/http会尝试缓冲全部内容 -
io.Pipe无缓冲，生产者/消费者速率不匹配时会阻塞，需配合 context 控制超时和取消 - 错误传播较隐晦：
pw.CloseWithError触发pr.Read返回 error，但 HTTP handler 已无法修改状态码
json.Marshal 切换到 easyjson + 复用 encoder，P99 延迟下降约 40%，但前提是结构体字段稳定、无频繁变更。动态字段、调试友好性、团队熟悉度这些隐性成本，往往比纯性能数字更影响最终选型。 
