HTTP条件写入 从强验证器到并发覆盖与重试边界
从一个具体请求或状态变化出发,追踪数据流与方法成立的条件。
章节速览7 节 · 展开选择
HTTP缓存用验证器判断已有表示能否继续复用,断点续传要求拼接字节来自同一版本。本篇把版本问题转向写入:甲乙都读到同一份文档,甲先保存后,怎样避免乙用旧副本覆盖甲的修改?
以下只有一份可整体替换的文本资源、两个编辑者和明确版本的教学模型。它不是本站后端功能说明,也不假定任何线上接口支持条件写入;报文与数据全部人工构造。
无条件保存,最后成功不等于结果正确
初始正文为“标题A,备注空”,版本为v1。甲把标题改成B,乙在自己仍是A的副本里填上备注C。如果两人都提交完整替换,甲先写得到“B,空”,乙后写则得到“A,C”。乙的请求成功了,甲已经成功的修改却消失。
这不是网络丢了甲的请求。问题是乙的新正文建立在旧状态上,而服务端没有要求“仅当当前状态仍是我读到的状态才替换”。RFC 9110 §13.1.1把If-Match用于这类防止丢失更新的条件请求。
| 步骤 | 甲的状态 | 乙的状态 | 服务端正文 |
|---|---|---|---|
| 初次读取 | A,空,v1 | A,空,v1 | A,空 |
| 甲保存 | B,空 | A,C,v1 | B,空,v2 |
| 乙无条件保存 | 已保存B | A,C | A,C |
| 乙携带旧条件 | 已保存B | A,C,v1 | 保持B,空,v2 |
最后两行是两种互斥方案,不是同一历史上连续发生的动作。条件失败保住了新状态,但并未替乙自动恢复正确的新正文。
用强验证器绑定读取与写入
设读取资源得到强ETag "v1"。乙保存时发送If-Match带上该标签。服务端在执行方法前检查当前表示的验证器;本文采用条件不成立就返回412且不执行写入的路径。
否则:返回412,正文与版本保持不变
比较与写入必须构成一个不可被其他写者插入的操作。这里只处理已授权、格式合法、资源存在的单资源完整替换。
ETag是带引号的不透明标记。"v2"不应被客户端解析为整数2并自行加一,也不能仅凭字典序判断哪个更新。本文用版本号便于讲解;实际生成策略和适用的表示变体由服务端决定。
flowchart TD
A[读取正文与强标签] --> B[基于该正文编辑]
B --> C[携带标签提交替换]
C --> D{原子检查标签}
D -->|匹配| E[写入并更新版本]
D -->|不匹配| F[拒绝旧副本覆盖]
报文表达条件,数据库负责落实原子性
下面是教学HTTP/1.1报文片段,省略Host等常规字段,不作为完整字节流示例。Content-Length若实际发送,必须按编码后的字节计算,本篇没有给一个可能与中文字符数混淆的长度值。
1 | PUT /notes/42 |
当服务端当前是v2时,本文路径返回412 Precondition Failed,保留“标题B,备注空”。如果应用先读取数据库版本,发现相等后退出事务,再单独执行无条件UPDATE,另一个写者仍可能在两步之间插入。请求头正确并不能弥补这样的检查与使用间隙。
可以把版本条件放入同一次数据库更新的谓词,或用适当事务保护比较和更新。SQLite事务中的条件更新与零行结果提供了相邻的数据库视角;本文并不把零行直接等同于HTTP状态码,映射仍需区分资源不存在、授权与其他业务条件。
自检1:读版本后再无条件写入,为什么仍可能覆盖别人?
其他写者可以在检查与写入之间更新。应由存储层保证条件判断和状态改变不可分割;仅在应用代码里先比较字符串不够。
强比较、星号与弱标签各自意味着什么
If-Match使用强比较:弱标签 W/"v1"不能与强标签 "v1"组成强匹配,即使引号内文字相同。缓存读取中If-None-Match使用弱比较的规则,不能挪到这里。比较规则与标签语义见RFC 9110 §8.8.3。
If-Match: *只要求存在当前表示,不要求它仍是读到的那一版,因此不能防止两个已存在版本之间的覆盖。反方向的 If-None-Match: *可表达只有没有当前表示时才进行创建;它也需要与创建动作原子结合,不能先查不存在再无条件插入。本文只把它用于指定资源URI的条件创建思路,不推广到任意POST业务。
两个条件分别解决“已有资源仍是这个版本”和“这个位置尚无当前表示”,不能混为一个通用幂等机制。版本条件更不替代身份认证、授权或输入校验。
412以后,不能只换个标签重放旧正文
乙收到412后重新读取v2,看到甲把标题改成B。若只把请求头换成v2,却仍发送旧正文“A,C”,这次条件可能通过,但甲的标题还是被覆盖。条件系统保证的是客户端承认基线,不能判断编辑者是否真正合并了修改。
乙应比较原始基线“A,空”、自己的草稿“A,C”与最新正文“B,空”,在这个不冲突的例子中形成“B,C”,然后基于最新标签提交。若甲乙同时改了标题,则需要明确冲突决策,不能把字段不冲突的例子当成一般自动合并证明。
flowchart TD A[收到条件失败] --> B[保留本地草稿] B --> C[读取最新正文与标签] C --> D[比较基线草稿与最新版] D --> E[解决冲突后重新提交] E --> F[仍须再次检查版本]
请求没有条件,与条件不成立要分开
接口若要求客户端带条件,可使用428 Precondition Required提示这一政策;它与已带旧标签而不成立的412不同。428来自RFC 6585 §3,并不是所有HTTP服务都必须启用的写入政策,也不能据此断言任何具体接口会返回它。
成功响应在网络上丢失时,客户端可能不知道先前写入是否完成。用旧标签重试通常会遇到新版本不匹配,但这不能单独证明“别人抢先写了”。RFC 9110还允许服务端在能确定该改变已经成功时返回成功状态;本文的简化模型没有实现这种识别。业务幂等键、操作记录与查询结果可以处理不同层面的重试问题,不能把If-Match视作完整的重复副作用保护。
自检2:条件失败后把If-Match换成最新标签,是否就算合并了?
不是。旧正文仍可能覆盖新字段。必须重新比较基线、自己的草稿和最新内容,得到确认过的结果,再以新基线提交。
参考资料
- RFC 9110 §13.1.1 If-Match、§8.8.3与§13.2:强验证器、条件求值与已成功请求的例外。
- RFC 6585 §3:428条件请求政策。报文、状态机与合并例子为教学构造,不是协议一致性认证。