.NET 6 EF Core一对多关系生成SQL外键关联错误问题

问题根因 #

当前Fluent API关系配置仅指定了依赖端（AssetIncident）的外键为InventoryProcessId，未显式指定主体端（InventoryProcessAsset）的关联字段，EF Core会默认选取主体实体的主键InventoryProcessAssetId作为关联目标，最终生成的JOIN条件为AssetIncident.InventoryProcessId = InventoryProcessAsset.InventoryProcessAssetId，和预期逻辑不符。

前置说明 #

EF Core的一对多/一对一关系要求主体端的关联字段必须具备唯一约束（主键默认自带唯一约束）。如果直接按预期将关联字段设为InventoryProcessAsset.InventoryProcessId，由于该字段在表中对应多条盘点资产记录（一个盘点流程下包含多个资产），不满足唯一约束要求，EF Core无法建立合规的外键关系，即使强行指定关联字段生成SQL，也会出现关联数据错配、重复的问题。
从导航属性的设计意图来看，AssetIncident.ProcessAsset指向单个盘点资产条目，标准实现应该通过InventoryProcessAsset的主键做关联。

修复方案 #

推荐：符合EF Core约定的标准实现 #

1. 修改AssetIncident实体，新增指向InventoryProcessAsset主键的外键字段：

   public class AssetIncident
   {
       [Key]
       public long AssetIncidentId { get; set; }
       public string AssetId { get; set; }
       public DateTime IncidentDate { get; set; }
       public byte IncidentType { get; set; }
       public string? Notes { get; set; }
   
       public Int64? InventoryProcessId { get; set; }
       // 新增盘点资产条目的外键字段
       public Int64? InventoryProcessAssetId { get; set; }
   
       public virtual Asset Asset { get; set; }
       public virtual InventoryProcessAsset ProcessAsset { get; set; }
   }
   

2. 调整Fluent API配置，显式指定关系的外键与主体键：

   modelBuilder.Entity<InventoryProcessAsset>()
       .HasMany<AssetIncident>(x => x.Incidents)
       .WithOne(g => g.ProcessAsset)
       .HasForeignKey(x => x.InventoryProcessAssetId)
       .HasPrincipalKey(x => x.InventoryProcessAssetId);
   

   配置完成后生成的SQL会自动通过主键做Left Join，原有Include用法无需改动即可返回正确的关联数据。

临时方案：不配置外键，手动指定关联字段 #

如果因为历史表结构限制无法修改字段，不需要依赖导航属性+Include的自动关联，可以直接用GroupJoin手动指定关联条件，绕开EF Core的外键约定：

var dbAssets = await _dbContext.InventoryProcessAssets
    .Where(i => i.InventoryProcessId == processId)
    .GroupJoin(
        inner: _dbContext.AssetIncidents,
        outerKeySelector: ipa => ipa.InventoryProcessId,
        innerKeySelector: ai => ai.InventoryProcessId,
        resultSelector: (ipa, incidents) => new 
        {
            InventoryProcessAsset = ipa,
            MatchedIncidents = incidents.ToList()
        }
    )
    .ToListAsync();

特殊场景：强制使用InventoryProcessId作为关联字段（不推荐） #

如果确认业务上InventoryProcessAsset.InventoryProcessId是全局唯一的（和当前实体设计逻辑冲突，仅特殊场景使用），可以先给该字段配置唯一约束，再显式指定关联的主体键：

// 给InventoryProcessId配置唯一约束
modelBuilder.Entity<InventoryProcessAsset>()
    .HasIndex(x => x.InventoryProcessId)
    .IsUnique();

// 配置关联关系
modelBuilder.Entity<InventoryProcessAsset>()
    .HasMany<AssetIncident>(x => x.Incidents)
    .WithOne(g => g.ProcessAsset)
    .HasForeignKey(x => x.InventoryProcessId)
    .HasPrincipalKey(x => x.InventoryProcessId);

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