Couchbase文档缺失却提示版本冲突的问题求助

团队告知有一个被其他文档引用的Couchbase文档缺失，从备份恢复后尝试通过Sync Gateway执行PUT命令：

curl -vXPUT -H'Content-Type:application/json' -d"@mydocument" "http://128.0.0.1:4985/mydatabase/aa987654-3210-4567-89cc-cba121212121"

返回冲突错误：

{"error":"conflict","reason":"Document revision conflict"}

但多次查询该文档均显示不存在：

• 基础GET查询：

  curl -vXGET "http://128.0.0.1:4985/mydatabase/aa987654-3210-4567-89cc-cba121212121"
  

  响应：{"error":"not_found","reason":"missing"}
• 带版本参数的GET查询：

  curl -vXGET "http://128.0.0.1:4985/mydatabase/aa987654-3210-4567-89cc-cba121212121?revs=true&open_revs=all"
  

  仍显示文档缺失
• 直接在Couchbase服务器执行N1QL查询：

  select * from mydatabase use keys "aa987654-3210-4567-89cc-cba121212121"
  

  返回结果为空：

  "results": [],
    "metrics": {
      "elapsedTime": "1.523366ms",
      "executionTime": "1.442059ms",
      "resultCount": 0,
      "resultSize": 0
    }
  }
  

1. 移除备份文档的_rev字段 #

备份文档可能包含旧的_rev值，Sync Gateway会验证该版本是否存在。如果文档已被彻底删除（含墓碑记录），但备份里的_rev对应历史版本，就会触发冲突。

• 操作：编辑备份的mydocument文件，删除_rev字段，再重新执行PUT命令。此时Sync Gateway会自动生成新的_rev，创建新文档。

2. 使用new_edits=false参数强制覆盖 #

如果需要保留备份文档的_rev并强制写入，可以在PUT请求中添加new_edits=false参数，绕过Sync Gateway的版本检查：

curl -vXPUT -H'Content-Type:application/json' -d"@mydocument" "http://128.0.0.1:4985/mydatabase/aa987654-3210-4567-89cc-cba121212121?new_edits=false"

该参数适用于恢复历史版本或解决墓碑记录导致的冲突。

3. 清理Sync Gateway的墓碑记录 #

即使Couchbase Server中无文档，Sync Gateway可能保留了文档的墓碑（删除标记），导致PUT冲突：

• 通过Sync Gateway管理API查询该文档的墓碑记录
• 调用Admin API删除对应的墓碑后，再执行PUT操作

4. 验证Sync Gateway与Couchbase Server同步状态 #

可能因缓存或同步延迟导致查询不一致：

• 重启Sync Gateway服务刷新缓存
• 检查Sync Gateway日志，确认是否存在同步错误

内容的提问来源于stack exchange，提问作者Justin Lloyd