.NET PascalCase类在Cosmos EF中实现camelCase及分区键错误排查

查询Cosmos数据时出现错误："实体类型'DataModel'的分区键设为'partitionKey'，但无对应属性"

DataModel类代码：

public class DataModel
{
    /* Properties - Serializable */
    public string Id { get; set; } = string.Empty;
    public int? Index { get; set; } = null;
    public string? PartitionKey { get; set; } = null;
    public string Name { get; set; } = string.Empty;
    public bool Locked { get; set; } = false;
    public string? LockedUser { get; set; } = null;
    public List<Record> Records { get; set; } = new List<Record>();
    public List<Field> Fields { get; set; } = new List<Field>();

    /* Properties - Not-Serializable */
    [JsonIgnore]
    [NotMapped]
    public Record? RootRecord = null;
    [JsonIgnore]
    [NotMapped]
    public BehaviorSubject<Record?> RootRecordBH = new BehaviorSubject<Record?>(null);
}

OnModelCreating实现：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<DataModel>().Property(x => x.Id).ToJsonProperty("id");
    modelBuilder.Entity<DataModel>().Property(x => x.Index).ToJsonProperty("index");
    modelBuilder.Entity<DataModel>().Property(x => x.PartitionKey).ToJsonProperty("partitionKey");
    modelBuilder.Entity<DataModel>().Property(x => x.Name).ToJsonProperty("name");
    modelBuilder.Entity<DataModel>().Property(x => x.Locked).ToJsonProperty("locked");
    modelBuilder.Entity<DataModel>().Property(x => x.LockedUser).ToJsonProperty("lockedUser");
    modelBuilder.Entity<DataModel>().Property(x => x.Records).ToJsonProperty("records");
    modelBuilder.Entity<DataModel>().Property(x => x.Fields).ToJsonProperty("fields");
    modelBuilder.Entity<DataModel>()
        .ToContainer("DataModels")
        .HasPartitionKey("partitionKey");
}

已知EF Core可通过ToJsonProperty控制Cosmos属性名，但配置无效，需排查问题。

• 核心问题：HasPartitionKey传入字符串参数时，EF Core会直接在实体类中查找同名的CLR属性，而非ToJsonProperty映射后的Cosmos字段名。你传入的是"partitionKey"，但实体类属性名为PartitionKey（大小写不一致），导致EF Core找不到匹配属性报错。

• 两种修复方式：

  1. 使用lambda表达式指定CLR属性（推荐，编译时即可校验）：
     修改HasPartitionKey的调用逻辑：

     modelBuilder.Entity<DataModel>()
         .ToContainer("DataModels")
         .HasPartitionKey(x => x.PartitionKey);
     

  2. 保持字符串参数，但与CLR属性名完全一致：
     若坚持用字符串参数，需传入实体类属性的实际名称"PartitionKey"：

     modelBuilder.Entity<DataModel>()
         .ToContainer("DataModels")
         .HasPartitionKey("PartitionKey");
     

• 补充说明：ToJsonProperty仅控制属性在Cosmos中的存储字段名，HasPartitionKey是指定实体类中哪个CLR属性作为分区键的数据源，二者作用对象不同，不要混淆。

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