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" 等操作根本不可用。
立即学习“go语言免费学习笔记（深入）”；
- 检查请求头：
r.Header.Get("Content-Type")必须是application/json-patch+json - 拒绝
Content-Type: application/json但 body 是 patch 数组的请求（属于协议误用） - 对
op: "test"操作必须严格校验，失败要返回409 Conflict，不能忽略
/id 或 /created_at），以及如何把 patch 结果安全落地到数据库——这些得靠业务层拦截，库本身不负责。 
