为什么Container.DeleteItemAsync未返回实际被删除的条目

问题原因与解决方案 #

1. 接口返回泛型ItemResponse<T>的设计逻辑 #

• 这是Azure Cosmos DB .NET SDK的统一接口设计规范，所有单文档操作（增、删、改、查、替换）的返回类型都保持一致，方便开发者复用响应处理逻辑，统一读取状态码、RU消耗、响应头等公共字段，避免不同操作的返回类型过度碎片化。

2. Resource属性默认返回null的原因 #

• Cosmos DB服务端的删除操作默认返回204 NoContent状态，响应体为空，这是默认的性能优化策略，减少不必要的网络传输开销。
• 全局配置的EnableContentResponseOnWrite = true参数默认仅对创建、替换、更新类写操作生效，不会自动作用于删除操作。

3. 正确获取被删除文档的方法 #

调用Container.DeleteItemAsync时，需要显式在DeleteItemOptions中开启返回内容的配置，示例代码如下：

ItemResponse<你的文档类型> deleteResponse = await container.DeleteItemAsync<你的文档类型>(
    id: "文档ID",
    partitionKey: new PartitionKey("分区键值"),
    options: new DeleteItemOptions
    {
        EnableContentResponseOnWrite = true
    });
// 配置生效后，deleteResponse.Resource即为被删除的文档实例

4. 低版本SDK设置参数不生效的处理 #

你测试的v3.14~v3.19版本确实存在已知bug，删除操作的EnableContentResponseOnWrite参数没有正确传递到服务端，升级SDK到v3.20及以上的稳定版本即可解决该问题。

内容的提问来源于stack exchange，提问作者Ramon de Klein