HotChocolate结合EF关联投影查询时表/列名不符问题

问题根源 #

• 错误使用OwnsMany配置：OwnsMany用于映射值对象集合（无独立表的嵌套数据），但你给ClientAPRole添加了DbSet，说明它是独立实体，应使用一对多的HasMany关系。
• EF默认按约定生成外键列名（类名+ID），但实际数据库的关联列并非FlatTableID，未显式指定导致不匹配。
• 未映射实体到数据库实际表名，EF默认用类名作为表名，和你数据库中的IMUK_PAF_ClientAPRoles表名不符。

解决方案 #

1. 修正DbContext的实体关系配置 #

将OwnsMany替换为HasMany，并显式指定外键、表名以匹配数据库结构：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 配置FlatTable与ClientAPRole的一对多关系
    modelBuilder.Entity<FlatTable>()
        .HasMany(f => f.IMUK_PAF_ClientAPRoles)
        .WithOne() // 若ClientAPRole无反向导航属性，保持此配置
        .HasForeignKey("实际数据库外键列名") // 替换为你数据库中关联FlatTable的列名，比如"FlatTable_Id"
        .IsRequired(false); // 根据业务需求设置是否必填

    // 显式绑定实体到数据库表名
    modelBuilder.Entity<FlatTable>()
        .ToTable("IMUK_PAF_FlatTable");

    modelBuilder.Entity<ClientAPRole>()
        .ToTable("IMUK_PAF_ClientAPRoles");

    base.OnModelCreating(modelBuilder);
}

2. （可选）实体属性与数据库列名映射 #

如果实体属性名和数据库列名不一致，用数据注解或Fluent API绑定：

• 数据注解方式：

[Column("数据库列名")]
public string? Status { get; set; }

• Fluent API方式：

modelBuilder.Entity<ClientAPRole>()
    .Property(c => c.Status)
    .HasColumnName("数据库列名");

3. 验证GraphQL字段映射 #

HotChocolate默认将C#帕斯卡命名转为驼峰命名，若你的查询字段是imuk_PAF_ClientAPRoles，需显式指定GraphQL字段名避免匹配错误：

[GraphQLName("imuk_PAF_ClientAPRoles")]
[UseSorting]
public ICollection<ClientAPRole>? IMUK_PAF_ClientAPRoles { get; set; }

验证 #

修改配置后重启项目，执行原GraphQL查询，EF将生成匹配实际数据库结构的SQL，解决报错问题。

内容的提问来源于stack exchange，提问作者De Wet van der Merwe