C# Cosmos DB：批量创建文档时如何替换ID相同的已有实体？

绝对有办法！你完全不用先手动检查文档是否存在——Cosmos DB 提供了Upsert操作，正好匹配你的需求：如果目标ID的文档已存在就直接替换，不存在则创建新文档，而且这是原子操作，能避免竞态条件的问题。

核心解决方案：替换为UpsertDocumentAsync #

Cosmos DB的UpsertDocumentAsync方法内置了"存在则更新，不存在则插入"的逻辑，省去了额外的存在性检查请求，同时保证操作的原子性。修改你的代码非常简单：

public async Task SaveAsync(IEnumerable<JObject> models) 
{ 
    foreach (var document in models) 
    { 
        var collectionLink = UriFactory.CreateDocumentCollectionUri(_databaseName, _collectionName); 
        // 用Upsert替代Create，实现自动判断替换/插入
        await _client.UpsertDocumentAsync(collectionLink, document); 
    } 
}

为什么这比先检查再操作更好？ #

• 避免竞态条件：如果先执行存在性检查，再执行创建/替换，中间可能有其他进程插入同ID的文档，导致你后续的创建操作报错。而Upsert是服务器端原子执行的，不会出现这种问题。
• 减少网络请求：省去了一次额外的ReadDocumentAsync检查请求，提升批量操作的效率。
• 完全匹配你的需求：Upsert会用你传入的新文档完全覆盖旧文档，正好符合你"新旧文档内容不同需要替换"的场景。

额外说明：如果需要部分更新怎么办？ #

如果你的需求不是完全替换文档，而是只更新部分字段，可以使用PatchDocumentAsync方法，通过指定更新路径来修改特定字段。但根据你的描述，完全替换文档的场景下，UpsertDocumentAsync是最简洁高效的选择。

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