知识条目 / Apache CouchDB
CouchDB 复制冲突与空间膨胀如何处理?
利用 _conflicts 与 _rev 分支识别冲突文档,结合 compaction 与 purge 回收空间。
CouchDB 采用多版本并发控制,复制时不会自动合并文档内容,而是保留多个修订分支形成冲突。冲突本身不会报错,但会让查询结果和存储空间出现异常。
处理步骤
- 识别冲突文档使用 ?conflicts=true 查询冲突标记,再通过 _revs_info 或 _open_revs 获取各分支内容,确认业务上应保留的版本。
- 制定合并策略按业务规则选择主版本并删除其他分支,或将字段合并后写入新修订。不要直接删除整个文档,以免丢失有效数据。
- 回收存储空间删除修订只是标记,旧数据仍占用磁盘。定期执行 compaction,必要时对已确认无用的修订执行 purge。
- 从复制设计上减少冲突明确文档归属节点,避免同一文档在多端高频并发写入。对必须双写的场景设计可合并的数据结构。
示例
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 · 文档