PUT 和 PATCH 到底怎么选·全量更新用错会有副作用

PATCH /api/users/1
Content-Type: application/json

{"nickname": "新昵称"}

// 服务端只更新非空字段

接口用 PUT 做局部更新，前端只传了改动的字段，结果其他字段被清空。这类现象通常不是突然出现的，往前翻半天日志能看到苗头。

追下去是这么回事：PUT 语义是整体替换，未提交的字段按缺省值处理；PATCH 才是局部修改。

「HTTP PUT 与 PATCH」确认了原因之后，改动尽量只碰那一处，顺手改的东西后面最容易出问题。监控和日志的时间要对上，时区不一致会多绕很大一圈。

临时改动用注释写上日期和原因，过两周自己都记不清为什么这么写。动手前把原文件复制一份带时间戳，出问题立刻换回去，比现场分析快得多。

一次只改一处，改完立刻验证，几个改动叠在一起，出问题就说不清是谁导致的。先做最小复现，能稳定跑出来的问题，排查成本会低一个数量级。

处理上按这个顺序：整体替换用 PUT 并要求提交完整资源；局部更新用 PATCH；文档里写清字段必填规则。

确认没问题再收工，局部更新后其他字段保持不变，接口行为与文档一致。