Azure Cosmos DB容器创建新记录遇分区键匹配问题求助

错误核心原因 #

你的容器分区键路径为/language，但当前代码存在两个关键问题：

1. 实体缺少分区键对应属性：Language类中没有映射到language字段的属性，Cosmos DB无法从文档中提取分区键值。
2. 分区键参数与文档值不匹配：调用CreateItemAsync时传入的固定字符串"language"，和文档中实际的分区键值（不存在）完全不匹配，导致系统判定两者不一致。

具体修复步骤 #

1. 给实体添加分区键属性 #

修改Language类，添加对应分区键路径的属性，用JsonProperty映射到"language"字段：

public class Language : Entity
{
    [JsonProperty("language")] // 对应容器分区键路径/language
    public string LanguageKey { get; set; }

    [JsonProperty("language_name")]
    public string Name { get; set; }

    [JsonProperty("language_image")]
    public string LanguageImage { get; set; }

    public Language() : base(true)
    {
    }
}

2. 修正仓储方法的分区键逻辑 #

确保传入的partitionKey值和实体中分区键属性的值完全一致，同时修复Id赋值错误（ActivityId是请求跟踪ID，并非文档自身ID）：

public async Task CreateAsync(TEntity entity, string partitionKey)
{
    // 泛型场景下可通过接口/反射统一设置分区键，这里以Language为例
    if (entity is Language lang)
    {
        lang.LanguageKey = partitionKey;
    }

    var itemResponse = await _container.CreateItemAsync<TEntity>(entity, new PartitionKey(partitionKey));
    entity.Id = itemResponse.Resource.Id; // 正确获取文档生成的ID
}

3. 调整请求体与控制器调用 #

更新Postman请求体，传入正确的分区键字段：

{
    "language": "Spanish",
    "language_name": "Spanish",
    "language_image": ""
}

也可以在控制器中统一设置分区键值，避免前端传入错误：

[HttpPost("language")]
public async Task<IActionResult> CreateLanguage(Language language)
{
    var partitionKey = language.Name; // 按业务逻辑取分区键值，比如和语言名称一致
    language.LanguageKey = partitionKey;
    await languageRepository.CreateAsync(language, partitionKey);
    return Ok();
}

关键注意事项 #

• 分区键路径/language要求文档必须包含顶级language字段，实体必须有对应的映射属性。
• 调用CreateItemAsync时，PartitionKey参数值必须和文档中language字段的值完全一致，大小写敏感。
• 泛型仓储可通过约定（比如所有实体实现带分区键属性的接口）来统一处理分区键赋值，减少重复代码。

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