EF Core如何基于自定义属性关联在单查询中Include关联实体

问题根因 #

当前FluentApi关联配置不完整：仅指定了Report端的关联主体键为TenantId，未显式指定Document端用于关联的外键字段，EF Core会按约定查找名为ReportId、ReportTenantId这类符合命名规则的外键，匹配失败后无法建立关联，因此Include查询时Documents列表始终为空。

推荐方案：修正关联配置（零实体修改，原生单查询支持） #

无需修改现有实体结构，仅需补全关联配置的外键映射，即可让原生Include语法正常工作，EF Core会自动生成带JOIN的单条SQL执行，性能最优且可全局复用。
修正后的OnModelCreating配置如下：

modelBuilder.Entity<Document>(b => {
    b.HasIndex(e => new { e.TenantId });
});

modelBuilder.Entity<Report>(b => {
    b.HasIndex(e => new { e.TenantId });
    b.HasMany(r => r.Documents)
     .WithOne()
     .HasPrincipalKey(r => r.TenantId) // 指定Report端用于关联的键
     .HasForeignKey<Document>(d => d.TenantId); // 指定Document端匹配的外键字段
});

配置完成后原有查询逻辑无需修改即可正常返回预期结果：

// 生成单条JOIN SQL，自动按TenantId匹配对应租户下的所有Document
var report = reportRepository.GetAll()
    .Where(r => r.Name == "abc")
    .Include(r => r.Documents)
    .First();

注意：该关联基于非主键字段TenantId建立，若业务上一个租户仅对应一条Report记录，建议给Report的TenantId添加唯一索引，避免关联时出现数据重复问题。

备选方案：过滤投影（无需修改全局配置） #

如果仅在个别场景需要这类关联，不想全局配置实体关系，可在EF Core 5.0及以上版本使用投影直接在单查询内完成关联加载，写法如下：

var report = reportRepository.GetAll()
    .Where(r => r.Name == "abc")
    .Select(r => new Report
    {
        TenantId = r.TenantId,
        Name = r.Name,
        Documents = documentRepository.GetAll()
                        .Where(d => d.TenantId == r.TenantId)
                        .ToList()
    })
    .First();

该写法同样会生成单条SQL执行，但需要每次查询时手动写映射逻辑，复用性较差，仅适合临时使用场景。

两次查询写法的缺陷 #

两次查询不仅多一次数据库往返开销，在批量查询Report列表时还会触发N+1查询问题，性能远低于单JOIN方案；全局配置关联后所有Report相关查询都可直接复用Include逻辑，维护成本更低。

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