SYSTEMS NOTES阅读地图
7个主要章节
1段代码示例
4组图片与图表

从一个具体请求或状态变化出发,追踪数据流与方法成立的条件。

章节速览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且不执行写入的路径。

约定C1|教学模型的原子条件写入
若当前版本 = 客户端读取版本:写入新正文并分配新版本
否则:返回412,正文与版本保持不变

比较与写入必须构成一个不可被其他写者插入的操作。这里只处理已授权、格式合法、资源存在的单资源完整替换。

ETag是带引号的不透明标记。"v2"不应被客户端解析为整数2并自行加一,也不能仅凭字典序判断哪个更新。本文用版本号便于讲解;实际生成策略和适用的表示变体由服务端决定。

报文表达条件,数据库负责落实原子性

下面是教学HTTP/1.1报文片段,省略Host等常规字段,不作为完整字节流示例。Content-Length若实际发送,必须按编码后的字节计算,本篇没有给一个可能与中文字符数混淆的长度值。

1
2
3
4
5
PUT /notes/42 HTTP/1.1
If-Match: "v1"
Content-Type: text/plain; charset=utf-8

标题A,备注C

当服务端当前是v2时,本文路径返回412 Precondition Failed,保留“标题B,备注空”。如果应用先读取数据库版本,发现相等后退出事务,再单独执行无条件UPDATE,另一个写者仍可能在两步之间插入。请求头正确并不能弥补这样的检查与使用间隙。

可以把版本条件放入同一次数据库更新的谓词,或用适当事务保护比较和更新。SQLite事务中的条件更新与零行结果提供了相邻的数据库视角;本文并不把零行直接等同于HTTP状态码,映射仍需区分资源不存在、授权与其他业务条件。

甲乙读取v1,甲匹配v1写入v2,乙仍带v1被拒绝,服务端保留v2
图1|原创顺序交错示意,不是网络抓包或并发性能实测。查看原图
自检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”,然后基于最新标签提交。若甲乙同时改了标题,则需要明确冲突决策,不能把字段不冲突的例子当成一般自动合并证明。

请求没有条件,与条件不成立要分开

接口若要求客户端带条件,可使用428 Precondition Required提示这一政策;它与已带旧标签而不成立的412不同。428来自RFC 6585 §3,并不是所有HTTP服务都必须启用的写入政策,也不能据此断言任何具体接口会返回它。

成功响应在网络上丢失时,客户端可能不知道先前写入是否完成。用旧标签重试通常会遇到新版本不匹配,但这不能单独证明“别人抢先写了”。RFC 9110还允许服务端在能确定该改变已经成功时返回成功状态;本文的简化模型没有实现这种识别。业务幂等键、操作记录与查询结果可以处理不同层面的重试问题,不能把If-Match视作完整的重复副作用保护。

自检2:条件失败后把If-Match换成最新标签,是否就算合并了?

不是。旧正文仍可能覆盖新字段。必须重新比较基线、自己的草稿和最新内容,得到确认过的结果,再以新基线提交。

参考资料

  1. RFC 9110 §13.1.1 If-Match、§8.8.3与§13.2:强验证器、条件求值与已成功请求的例外。
  2. RFC 6585 §3:428条件请求政策。报文、状态机与合并例子为教学构造,不是协议一致性认证。