Golang处理JSONPatch请求详解

本篇文章给大家分享《Golang处理JSON Patch请求方法》，覆盖了Golang的常见基础知识，其实一个语言的全部知识点一篇文章是不可能说完的，但希望通过这些问题，让读者对自己的掌握程度有一定的认识(B 数)，从而弥补自己的不足，更好的掌握它。

application/json-patch+json 是遵循 RFC 6902 的标准格式，以数组形式描述对 JSON 文档的增删改操作，需用 jsonpatch.DecodePatch 解析并 Apply 到原始数据，不可当作普通 JSON 或部分 POST 处理。

什么是 application/json-patch+json 请求

JSON Patch 是一种标准格式（RFC 6902），用数组描述对 JSON 文档的增删改操作，不是简单地传部分字段。Golang 默认的 json.Unmarshal 无法直接解析它——它期望一个完整对象，而 JSON Patch 是形如 [{"op":"replace","path":"/name","value":"alice"}] 的操作指令列表。

用 github.com/evanphx/json-patch 应用 patch 到原始数据

这是最稳妥的第三方库，专为 RFC 6902 设计，能正确处理嵌套路径、数组索引、test 操作和错误定位。别自己手写遍历逻辑，容易漏掉 move、copy 或路径转义问题。

• 先读取原始资源（比如从 DB 加载的 struct）并序列化为 []byte
• 读取请求体（io.ReadAll(r.Body)），确保它是合法的 JSON Patch 数组
• 调用 jsonpatch.DecodePatch 解析，再用 patch.Apply 应用到原始 JSON 上
• 最后反序列化回目标 struct（如果需要强类型校验）

raw, _ := json.Marshal(existingUser)
patchData, _ := io.ReadAll(r.Body)
patch, _ := jsonpatch.DecodePatch(patchData)
modified, _ := patch.Apply(raw)
var updated User
json.Unmarshal(modified, &updated)

json.RawMessage 在中间层避免重复编解码

如果你只做字段更新、不验证语义，且原始数据已经是 json.RawMessage 类型（比如从数据库读出的 JSON 字段），可以直接传给 patch.Apply，跳过 Marshal → Unmarshal 循环，减少内存拷贝和 GC 压力。

• 声明字段时用 json.RawMessage 而非 map[string]interface{} 或具体 struct
• 确保传入 patch.Apply 的是原始字节切片，不是已解析的 Go map
• 注意：RawMessage 不做 schema 校验，错误 patch 可能静默失败或 panic

常见错误：把 PATCH 当成“部分 POST”来处理

很多人误以为客户端发 {"name":"alice"} 就是 JSON Patch，于是用 json.Decoder 直接 decode 到 struct 指针，再用 reflect 判断字段是否零值来决定更新——这完全违背 RFC，也导致 op: "remove"、op: "add" 等操作根本不可用。

• 检查请求头：r.Header.Get("Content-Type") 必须是 application/json-patch+json
• 拒绝 Content-Type: application/json 但 body 是 patch 数组的请求（属于协议误用）
• 对 op: "test" 操作必须严格校验，失败要返回 409 Conflict，不能忽略

今天关于《Golang处理JSONPatch请求详解》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！