知识条目 / Apache CouchDB

CouchDB 复制冲突与空间膨胀如何处理?

利用 _conflicts 与 _rev 分支识别冲突文档,结合 compaction 与 purge 回收空间。

CouchDB 采用多版本并发控制,复制时不会自动合并文档内容,而是保留多个修订分支形成冲突。冲突本身不会报错,但会让查询结果和存储空间出现异常。

处理步骤

  1. 识别冲突文档使用 ?conflicts=true 查询冲突标记,再通过 _revs_info 或 _open_revs 获取各分支内容,确认业务上应保留的版本。
  2. 制定合并策略按业务规则选择主版本并删除其他分支,或将字段合并后写入新修订。不要直接删除整个文档,以免丢失有效数据。
  3. 回收存储空间删除修订只是标记,旧数据仍占用磁盘。定期执行 compaction,必要时对已确认无用的修订执行 purge。
  4. 从复制设计上减少冲突明确文档归属节点,避免同一文档在多端高频并发写入。对必须双写的场景设计可合并的数据结构。

示例

GET /app/_all_docs?include_docs=true&conflicts=true

GET /app/doc-1001?conflicts=true

GET /app/doc-1001?rev=<revision>&revs_info=true

POST /app/_compact
Content-Type: application/json

POST /app/_purge
Content-Type: application/json
{ "doc-1001": ["2-abc...", "2-def..."] }

purge 不可恢复且需要管理员权限,执行前必须确认修订已合并并完成备份。

关键词

couchdb · 复制 · 冲突 · conflicts · revision · _rev · compaction · 压缩 · purge · 文档