如何通过Python的PUT请求更新CouchDB文档及文档ID？

首先明确核心限制：CouchDB的_id是文档的唯一标识，一旦创建无法直接修改。要实现类似修改_id的效果，只能通过「复制旧文档到新_id的文档 + 删除旧文档」的方式完成。

1. 准备依赖 #

使用requests库发送HTTP请求，先安装依赖：

pip install requests

2. 具体实现步骤 #

步骤1：获取旧文档完整数据（含版本号_rev） #

CouchDB的更新/删除操作必须依赖_rev进行冲突检测，所以先获取目标旧文档的全部数据：

import requests

# 配置CouchDB连接信息
COUCHDB_HOST = "http://localhost:5984"
DB_NAME = "你的数据库名称"
OLD_DOC_ID = "需要修改_id的旧文档ID"
NEW_DOC_ID = "新的文档ID"
AUTH = ("用户名", "密码")  # 若CouchDB未启用认证可省略此参数

# 获取旧文档
resp = requests.get(f"{COUCHDB_HOST}/{DB_NAME}/{OLD_DOC_ID}", auth=AUTH)
old_doc = resp.json()

if "error" in old_doc:
    print(f"获取旧文档失败: {old_doc['error']}")
    exit()

步骤2：创建新_id的文档 #

复制旧文档的数据，替换_id并移除旧版本号_rev（新文档为全新资源，不需要旧版本信息）：

# 构建新文档
new_doc = old_doc.copy()
new_doc["_id"] = NEW_DOC_ID
del new_doc["_rev"]

# 上传新文档到CouchDB
resp = requests.put(f"{COUCHDB_HOST}/{DB_NAME}/{NEW_DOC_ID}", json=new_doc, auth=AUTH)
result = resp.json()

if "error" in result:
    print(f"创建新文档失败: {result['error']}")
    exit()
print(f"新文档创建成功: {result}")

步骤3：删除旧文档 #

使用旧文档的_rev版本号执行删除操作：

# 删除旧文档
resp = requests.delete(
    f"{COUCHDB_HOST}/{DB_NAME}/{OLD_DOC_ID}?rev={old_doc['_rev']}",
    auth=AUTH
)
delete_result = resp.json()

if "error" in delete_result:
    print(f"删除旧文档失败: {delete_result['error']}")
else:
    print(f"旧文档删除成功: {delete_result}")

3. 关键注意事项 #

• 版本冲突处理：如果在获取旧文档到删除旧文档的间隙，旧文档被其他请求修改，删除操作会失败，需重新获取最新的_rev后重试。
• 权限验证：确保CouchDB用户拥有目标数据库的_read、_write、_delete权限。
• 关联数据同步：若有其他文档引用了旧_id，需同步更新这些引用，避免数据关联断裂。

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