Python删除Azure Cosmos DB分区集合文档报错求助

嘿，我之前处理Cosmos DB分区集合的删除操作时也踩过一模一样的坑！非分区集合随便删都没问题，但分区集合就各种报错，咱们来拆解一下问题和解决办法：

先搞懂报错的核心原因 #

• 400错误：分区集合的所有写操作（包括删除）都必须指定分区键值——这是用来告诉Cosmos DB该路由到哪个物理分区的关键信息。没传这个参数的话，服务端根本不知道该去哪找目标文档，直接返回400 Bad Request。
• 404错误：你加了分区键参数但还是找不到资源，大概率是参数不匹配——要么是分区键的字段名写错了，要么是值的类型和文档里的不一致（比如文档里是整数123，你传了字符串"123"），或者你备份的_self链接对应的文档已经被删除过了。

修正你的操作流程 #

你的「备份→提取_self→遍历删除」思路没问题，但关键是要同时保存文档的分区键值，而不是只存_self。下面是具体的代码调整示例（以常用的Azure Cosmos Python SDK v4.x为例）：

1. 备份文档时同时记录分区键值 #

import json
from azure.cosmos import CosmosClient

# 替换成你的实际配置
endpoint = "your-cosmos-endpoint"
key = "your-cosmos-key"
db_name = "your-db-name"
container_name = "your-partitioned-container-name"
partition_key_field = "category"  # 比如容器分区键是"/user_id"就写"user_id"

client = CosmosClient(endpoint, key)
database = client.get_database_client(db_name)
container = database.get_container_client(container_name)

backup_records = []
# 写入备份文件并记录删除所需的关键信息
with open("cosmos_backup.json", "w", encoding="utf-8") as f:
    for item in container.query_items(
        query="SELECT * FROM c",
        enable_cross_partition_query=True  # 分区集合全量查询必须开启这个
    ):
        f.write(f"{json.dumps(item, ensure_ascii=False)}\n")
        backup_records.append({
            "self_link": item["_self"],
            "partition_value": item[partition_key_field]
        })

2. 遍历删除时传入正确的分区键参数 #

from azure.cosmos import exceptions

for record in backup_records:
    try:
        container.delete_item(
            item=record["self_link"],
            partition_key=record["partition_value"]  # 核心：必须显式传这个参数
        )
        print(f"成功删除文档: {record['self_link']}")
    except exceptions.CosmosResourceNotFoundError:
        print(f"文档不存在或已被删除: {record['self_link']}")
    except exceptions.CosmosHttpResponseError as e:
        print(f"删除失败: {e.message}")

额外排查点（如果还是报错） #

如果调整后依然出现404，可以检查这些细节：

• 确认分区键字段名完全匹配：比如容器的分区键是/user_id，你就必须用item["user_id"]，不能写成item["userId"]或者其他变体。
• 检查分区键值的类型：比如文档里的分区键是布尔值true，你不能传字符串"true"，类型必须严格一致。
• 如果你用的是SDK v3.x，API写法略有不同，但核心逻辑不变——依然要传partition_key参数，别搞错参数位置。

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