NoSQL 与搜索 / 系统课时
并发更新控制
并发更新控制
本课解决多个客户端同时修改同一文档时的覆盖问题。你将使用 _seq_no 与 _primary_term 组成版本条件,让过期请求明确失败,而不是悄悄把新数据改回旧值。
学习目标
- 理解序列号与主分片任期分别解决什么问题
- 使用
if_seq_no和if_primary_term执行条件更新 - 识别版本冲突,并选择重试或返回业务失败
为什么普通更新会丢数据
假设客户端 A 和客户端 B 同时读取库存 10。A 售出 1 件并写入 9,B 也基于旧值计算后写入 9。两次请求都成功,但实际售出 2 件,正确库存应为 8。问题不在于 Elasticsearch 无法并发写入,而在于第二次写入没有证明自己基于最新数据。
Elasticsearch 为每次文档变更分配递增的 _seq_no。主分片每次重新选举后,_primary_term 会变化。两者一起标识“这份文档状态来自哪一代主分片、处于哪个写入位置”,可以防止旧主分片或旧读取结果覆盖新状态。

创建可重复的测试数据
下面命令重建测试索引,并写入一条库存文档。示例假设 Elasticsearch 位于本机 9200 端口,未启用身份认证;实际环境应替换地址和认证参数。
curl -s -X DELETE "http://localhost:9200/inventory_occ_demo" > /dev/null
curl -s -X PUT "http://localhost:9200/inventory_occ_demo" \
-H "Content-Type: application/json" \
-d '{"mappings":{"properties":{"stock":{"type":"integer"}}}}' > /dev/null
curl -s -X PUT "http://localhost:9200/inventory_occ_demo/_doc/stock-1?refresh=true" \
-H "Content-Type: application/json" \
-d '{"stock":10}'预期结果(保留关键字段)
{
"_index": "inventory_occ_demo",
"_id": "stock-1",
"_version": 1,
"result": "created",
"_seq_no": 0,
"_primary_term": 1
}如果索引曾被系统自动恢复或主分片发生过切换,_primary_term 可能不是 1。后续请求应始终使用读取结果中的实际值。
读取并携带版本条件更新
先读取文档,记录响应中的 _seq_no 和 _primary_term。
curl -s "http://localhost:9200/inventory_occ_demo/_doc/stock-1"预期结果(保留关键字段)
{
"_index": "inventory_occ_demo",
"_id": "stock-1",
"_version": 1,
"_seq_no": 0,
"_primary_term": 1,
"found": true,
"_source": {
"stock": 10
}
}接着把这两个值放入更新请求的查询参数。只有文档仍处于该状态时,更新才会成功。
curl -s -X POST \
"http://localhost:9200/inventory_occ_demo/_update/stock-1?if_seq_no=0&if_primary_term=1&refresh=true" \
-H "Content-Type: application/json" \
-d '{"doc":{"stock":9}}'预期结果(保留关键字段)
{
"_index": "inventory_occ_demo",
"_id": "stock-1",
"_version": 2,
"result": "updated",
"_seq_no": 1,
"_primary_term": 1
}此时再使用旧条件提交更新,Elasticsearch 会拒绝请求,而不是覆盖刚写入的库存。
curl -s -i -X POST \
"http://localhost:9200/inventory_occ_demo/_update/stock-1?if_seq_no=0&if_primary_term=1" \
-H "Content-Type: application/json" \
-d '{"doc":{"stock":8}}'预期结果
HTTP/1.1 409 Conflict响应体中的错误类型为 version_conflict_engine_exception。这表示条件不再成立,客户端必须重新读取最新文档后再决定是否重算并重试。
冲突后的处理策略
乐观并发控制不会自动判断业务意图。遇到 409 时,计数累加、库存扣减等可交换操作,通常适合重新读取并有限重试;用户编辑资料、审批状态变更等覆盖风险较高的操作,更适合把冲突返回给调用方,让用户确认最新状态。
retry_on_conflict 适用于使用脚本或局部更新、且业务允许按最新值重复计算的场景。它只是重新执行更新,不等价于携带明确的 _seq_no 与 _primary_term 条件,也不应设置成无限重试。高冲突热点应进一步考虑拆分文档、队列串行化或在业务层聚合写入。
验证最终状态
最后读取文档,确认失败的旧请求没有覆盖成功结果。
curl -s "http://localhost:9200/inventory_occ_demo/_doc/stock-1?_source=stock"预期结果(保留关键字段)
{
"_index": "inventory_occ_demo",
"_id": "stock-1",
"_version": 2,
"_seq_no": 1,
"_primary_term": 1,
"found": true,
"_source": {
"stock": 9
}
}本课总结
_seq_no标识写入顺序,_primary_term标识主分片任期,两者共同构成可靠的并发条件if_seq_no与if_primary_term能把过期更新转换为明确的409冲突- 冲突后应按业务语义选择重算重试、返回用户确认或降低热点写入竞争
下一课预告
下一课将把索引映射变更与线上迁移结合起来,使用 Reindex API 和别名完成无停机重建与切换。