EF Core LINQ带别名关联查询出错的技术求助

问题背景 #

通过EF DataContext绑定GridControl展示ProductSubProductRate数据，需关联查询LibraryCustomer表的客户名称，尝试LINQ查询和手动SQL查询均报错，同时要保证数据插入功能正常。

错误原因分析 #

1. Include操作报错：原LINQ查询中Include(c => c.Customer)后使用Select投影到匿名类型，EF Core中Include仅对返回实体本身的查询有效，投影后Include会失效并触发语法错误。
2. 未知列错误：EF Core默认约定外键名为[导航属性名]Id（即modelLibraryCustomerId），但实体类中外键是IdCustomer，数据注解未被正确识别，导致生成的SQL使用错误的外键列名。
3. FromSQL缺少列错误：手动SQL查询返回的列未匹配EF Core期望的外键列名（仍按默认约定查找modelLibraryCustomerId），即使返回了IdCustomer也无法被识别。

解决方案 #

1. 显式配置实体关系（关键步骤） #

在DbContext的OnModelCreating方法中手动配置实体关联，覆盖EF Core的默认约定，确保外键识别正确：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 配置ProductSubProductRate与Customer的关联
    modelBuilder.Entity<modelDataProductSubProductRate>()
        .HasOne(pr => pr.Customer)
        .WithMany(c => c.SubProductRate)
        .HasForeignKey(pr => pr.IdCustomer) // 指定外键为IdCustomer
        .IsRequired(false); // 匹配IdCustomer可空的定义
}

2. 修正LINQ查询（推荐方案） #

移除无意义的Include，直接在Select中访问导航属性，EF会自动生成关联查询，同时保证投影字段与GridControl列名匹配：

// 构建查询并投影到匿名类型
var rateData = this.contextSQL.ProductSubProductRate
    .Where(pr => pr.IdSubProduct == this.parameter.Id.ToString())
    .OrderByDescending(pr => pr.EffectiveDate)
    .Select(pr => new 
    { 
        CustomerName = pr.Customer?.Name ?? string.Empty, // 处理Customer为null的情况
        pr.IdSubProduct, 
        pr.EffectiveDate,
        pr.Rate,
        pr.Additional,
        pr.Id // 如果GridControl需要主键字段可添加
    })
    .ToList();

// 绑定到GridControl
this.gridRateManager.DataSource = rateData;

3. 手动SQL查询的兼容方案（若必须使用） #

如果坚持使用FromSQL，需要确保返回列包含EF Core期望的字段名，或者使用无跟踪查询避免EF验证实体完整性：

var IdSubProduct = new MySqlConnector.MySqlParameter("IdSubProduct", this.parameter.Id.ToString());

// 修改SQL，添加别名匹配EF期望的外键列名（不推荐，易受实体结构变更影响）
FormattableString cmd = $@"SELECT spr.*, c.Name CustomerName, spr.IdCustomer AS modelLibraryCustomerId 
    FROM ProductSubProductRate spr 
    LEFT JOIN LibraryCustomer c ON (c.Id = spr.IdCustomer)
    WHERE (spr.IdSubProduct = {IdSubProduct})";

// 使用AsNoTracking避免EF验证实体状态
var rateData = this.contextSQL.ProductSubProductRate
    .FromSql(cmd)
    .AsNoTracking()
    .ToList();

this.gridRateManager.DataSource = rateData;

插入功能保障 #

上述方案中，查询操作使用投影或无跟踪查询，不会影响实体的插入逻辑。插入时直接操作modelDataProductSubProductRate实体即可：

var newRate = new modelDataProductSubProductRate
{
    Id = Guid.NewGuid().ToString(),
    IdSubProduct = "xxx",
    EffectiveDate = DateOnly.FromDateTime(DateTime.Now),
    Rate = 0.05m,
    IdCustomer = "customerId" // 关联客户ID
};

this.contextSQL.ProductSubProductRate.Add(newRate);
this.contextSQL.SaveChanges();

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