CouchDB冲突解决后文档莫名删除问题求助

可能的原因 #

• Fauxton UI操作隐患：多次手动解决冲突时，Fauxton的冲突解决界面可能存在交互逻辑缺陷，比如误将某个隐藏的_deleted标记带入获胜版本，或者UI按钮布局易导致误触发删除操作（即使你主观上未执行删除）。
• 双向复制的循环冲突处理异常：双向同步场景下，每次冲突解决生成的新版本会同步至另一端，触发新一轮冲突。多次循环后，CouchDB的复制进程在处理过长的文档版本链时，可能出现逻辑错误，错误标记文档为已删除。
• CouchDB 3.3.2版本bug：该版本存在与冲突解决、版本链管理相关的已知问题，当同一文档经历多次冲突解决后，系统在版本清理或同步过程中误设_deleted=true字段。

解决建议 #

• 替换手动UI冲突解决方式：改用CouchDB API或命令行工具处理冲突，避免UI误操作：
  1. 发送GET /{db}/{doc_id}?open_revs=all获取文档所有冲突版本；
  2. 选择正确的版本，提取所需字段，构造不包含_deleted字段的新文档；
  3. 发送PUT /{db}/{doc_id}更新文档，带上正确的_rev值。
• 检查并优化双向复制配置：
  • 确保两个实例的复制器为独立的单向配置（本地→云端、云端→本地各一个），避免循环复制逻辑混乱；
  • 复制配置中添加selector过滤条件，仅同步需要的文档类型，减少不必要的冲突；
  • 查看复制器日志（/var/log/couchdb/replicator.log），排查是否有异常报错信息。
• 升级CouchDB版本：将实例升级至3.x系列的最新稳定版（如3.3.3及以上），官方后续版本修复了部分冲突处理相关的bug。
• 排查文档版本历史：对被误删的文档，执行GET /{db}/{doc_id}?open_revs=all查看所有版本，确认_deleted标记首次出现的版本，回溯对应的冲突解决操作，定位问题根源。
• 启用自动冲突解决策略：在复制配置中设置conflict_strategy参数，比如选择winner_takes_all（以最新版本为获胜方）或replicate_conflicts（保留冲突版本待后续处理），减少手动操作的风险。若需自定义逻辑，可编写复制过滤器或冲突解决函数。
• 开启复制日志监控：将CouchDB的日志级别设为debug，当文档被误删时，查看日志中对应的复制和冲突解决操作记录，精准定位触发删除的环节。

内容的提问来源于stack exchange，提问作者Scott Mitchell