17370845950

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，不能忽略

真正难的不是应用 patch，而是定义清楚哪些字段允许被 patch、哪些路径禁止修改（比如 /id 或 /created_at），以及如何把 patch 结果安全落地到数据库——这些得靠业务层拦截，库本身不负责。