两个人打开同一份配置,甲改标题并保存,乙稍后改备注并保存。界面都提示成功,但甲的标题消失了。前端禁用重复点击只能约束本页面,不能防止别的标签、用户或后台任务同时修改数据。
并发编辑需要接口证明“这次修改是基于哪一版”。本文讨论整份文档 PUT 的乐观并发控制,不把它扩展成自动协同编辑,也不假设浏览器缓存本身会保护业务写入。
读取时保存内容和验证器
读取文档时同时取得表示及其 ETag,并在草稿旁保存这一基线。保存时带 If-Match,让服务端只在当前表示仍匹配时执行。条件不满足时返回 412,前端进入冲突状态。HTTP 条件请求与强比较的规则见 RFC 9110。
用于写入的验证器需要符合强比较语义。不要去掉 W/ 前缀就把弱验证器伪装成强验证器,也不要自行猜测服务器的 ETag 算法。跨域接口还要暴露响应 ETag,并允许需要的条件请求头,否则代码可能拿不到服务端已经发送的信息。
检查和更新必须是一次原子操作
下面前端函数在 412 时返回明确冲突,不自动覆盖。服务端 SQL 示例展示版本条件;事务内还要处理权限、业务校验及对应的 HTTP 映射。它不规定 ETag 必须直接等于数据库版本,验证器到当前表示的映射仍由服务端负责。
export async function saveDraft(url, draft, etag, signal) {
if (!etag || etag.startsWith('W/')) {
throw new Error('a strong revision validator is required');
}
const response = await fetch(url, {
method: 'PUT',
headers: { 'Content-Type': 'application/json', 'If-Match': etag },
body: JSON.stringify(draft),
signal,
});
if (response.status === 412) return { kind: 'conflict', draft };
if (!response.ok) throw new Error(`save failed: ${response.status}`);
return {
kind: 'saved',
etag: response.headers.get('ETag'),
};
}
-- Execute atomically; zero updated rows means the expected version lost.
UPDATE documents
SET body = $1, version = version + 1
WHERE id = $2 AND tenant_id = $3 AND version = $4
RETURNING version;
先读取版本、在应用里比较、最后无条件更新,会在比较与写入之间再开一个竞态窗口。应使用带版本条件的更新或等效原子机制。零行更新还可能意味着资源删除或权限条件不成立,服务端需要按授权策略区分,不能把敏感资源存在性随意泄露。
冲突时保留三份信息
界面需要基线、当前本地草稿和最新远端文档。三方比较可以发现甲乙是否改了不同字段,但自动合并仍要按业务语义判断。标题与标题可能冲突,金额与币种即使是不同字段也未必能独立合并,数组顺序更不能按索引机械合并。
显示可理解的差异,让用户选择保留本地、接受远端或手工调整。若用户决定基于最新版本再提交,应更新基线并再次带条件;冲突处理完成前不能偷偷发送一个没有条件的 PUT。自动重试 412 只会把被保护的覆盖重新变成最后写入获胜。
保存成功也要对应发出的那份草稿
用户在保存 A 期间继续输入 B,A 成功后不能把 B 全部标成已保存。保存请求应携带本地修订身份,成功后只推进对应基线,并保留较新的编辑。新的 ETag 属于服务端确认的结果,而不是随便绑定到当前输入框内容。
示例允许成功响应没有 ETag;这种情况下 UI 可以说明已保存,但再次安全写入前应重新获取验证器,不能继续用旧值。若接口会规范化内容,例如整理空白或补默认值,还要约定成功后返回表示或要求重新读取,防止本地基线与实际存储分歧。
超时与冲突是不同的恢复问题
412 表示条件没有满足;网络超时则可能是写入成功但响应丢失。后者不要直接显示“肯定没保存”。可以重新读取并比较业务修订,或使用服务端支持的请求身份查询结果。幂等语义和并发验证分别解决重复执行与丢失更新,不能相互代替。
测试两个客户端读取同一基线后依次保存、保存中继续编辑、删除后保存、跨域头缺失、响应丢失以及服务端规范化。断言不仅是状态码,还包括本地草稿没有丢失、下一次保存使用正确基线。能够解释并恢复的冲突,远比两个虚假的“保存成功”可靠。
