如何从CouchDB文档中移除_deleted_conflicts字段？

问题背景 #

调用POST /{db}/_design/{designDoc}/_view/{view}接口时，返回的文档包含"_conflicts": ["{conflictRev}"]字段。通过POST /{db}/_bulk_docs接口删除冲突版本，请求内容如下：

{
  "docs": [
    {
      "_id": "{docId}",
      "_rev": "{conflictRev}",
      "_deleted": true
    }
  ]
}

操作后检索文档，出现新字段"_deleted_conflicts": ["{deletedConflictRev}"]，影响后端应用运行。尝试用POST /{db}/_purge接口传入以下内容：

{
  "{docId}": [
    "{deletedConflictRev}"
  ]
}

但操作后文档完全消失，CouchDB UI和应用中均无法找到，疑似索引同步问题。现需彻底移除文档中的冲突信息。

解决方案 #

1. 正确使用_purge接口（避免文档消失） #

之前的_purge操作导致文档消失，是因为误操作删除了文档主版本的修订记录。_purge需明确指定要清除的冲突修订ID，而非当前活跃的主版本：

• 先通过GET /{db}/{docId}获取文档当前的主修订版本（_rev字段），确认要清除的是冲突修订ID而非主版本。
• 正确的_purge请求体格式：

{
  "{docId}": ["{conflictRev}"]
}

注意：_purge会永久删除指定修订且无法恢复，执行前务必确认目标是冲突版本。

2. 彻底移除_deleted_conflicts字段 #

_deleted_conflicts是CouchDB记录已删除冲突版本的元数据字段，需结合两步操作清除：

1. 用_purge清除所有冲突修订记录（包括已标记为_deleted的冲突版本）。
2. 对文档主版本执行一次无实质变更的更新（比如临时添加一个无关字段后再删除，或直接提交相同内容），触发CouchDB重新生成文档元数据，此时_deleted_conflicts字段会被自动移除。

3. 修复索引同步问题（恢复消失的文档） #

若_purge后文档消失，是视图索引未同步导致：

• 调用POST /{db}/_design/{designDoc}/_view/{view}?stale=false强制刷新视图索引。
• 或通过CouchDB UI的「Views」页面，点击对应视图的「Build Index」按钮重建索引。

关键注意事项 #

• 确认数据库启用purge功能：CouchDB 3.x默认启用，可检查配置文件[database]段中enable_purge = true。
• _purge操作后必须刷新所有相关视图索引，避免查询结果异常。

内容的提问来源于stack exchange，提问作者Bogdan Goncharenko