Iris 的 app.Patch() 仅注册路由并接收请求，不自动实现部分更新；需手动用指针结构体或 map 判断字段是否提供，再选择性更新，且测试时必须调用 app.Build()。
PATCH 请求在 Iris 里不是靠 app.Patch() 自动合并字段，而是得你自己读、自己判、自己更新——框架不帮你做“部分更新”逻辑。
为什么 app.Patch() 不等于“自动部分更新”
Iris 的 app.Patch() 只负责注册路由和接收请求体，它不会像某些 ORM 或高级 API 框架那样解析 JSON 并只更新非空字段。PATCH 的语义（RFC 5789）是“对资源做局部修改”，但这个“局部”必须由你代码定义。
- 常见错误：把 PATCH 当成“轻量版 PUT”，直接
db.Save(&user)，结果把零值字段（如Age: 0、Name: ""）也刷进数据库 - 真实场景：前端只传了
{"email": "new@example.com"}，你不该覆盖name、age等其他字段 - 根本原因：Go 的 struct 默认零值不可区分“未提供”和“明确设为零”，JSON 解码后所有字段都会被赋值
用指针字段 + json:",omitempty" 判断字段是否提供
这是最轻量、无额外依赖的方案：把要支持 PATCH 的字段全改成指针类型，再配合 JSON tag 控制解码行为。
<pre class="brush:php;toolbar:false;">type UserPatch struct {
Name *string `json:"name,omitempty"`
Email *string `json:"email,omitempty"`
Age *int `json:"age,omitempty"`
}
- 前端只传
{"email": "a@b.c"} → 只有Email字段非 nil，其余为nil - 在 handler 里逐个判断：
if req.Email != nil { user.Email = *req.Email } - 注意：不能用
omitempty单独控制，必须配指针；否则Age: 0会被忽略，但Age: 0可能是合法业务值
用 map[string]interface{} 动态处理 PATCH 字段
适合字段多、结构不稳定、或需要统一校验逻辑的场景，但会丢失编译期类型检查。
- 先
ctx.ReadJSON(&patchMap)读成map[string]interface{} - 手动检查 key 是否在白名单中（防止恶意字段注入），例如只允许
"name","email" - 用类型断言提取值：
if email, ok := patchMap["email"].(string); ok { user.Email = email } - 性能略低，但灵活：可统一加审计日志、字段变更通知等逻辑
- 别直接
db.Model(&user).Updates(patchMap)—— GORM 的Updates会把0/""当有效值写入，仍需过滤
别踩 iris.Test() 里 PATCH 路由找不到的坑
测试 PATCH 接口时，如果 iris.Test() 返回 404，大概率不是路由写错了，而是没调 app.Build()。
-
app.Patch("/users/{id:uint64}", handler)注册完，必须显式调app.Build()才能被iris.Test()识别 - 测试函数内写：
app.Build(); iris.Test(app, "PATCH", "/users/123", iris.WithJSONBody(`{"name":"x"}`)) - 漏掉
app.Build()是本地调试和单元测试中最常卡住的地方，不是 bug，是 Iris 的设计约束
真正难的不是写 PATCH 路由，而是决定哪些字段允许 PATCH、哪些要拒绝、零值字段怎么语义化处理——这些没法靠框架自动推断，得你在 handler 里一行行写清楚。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
