EF Core导航属性为NULL问题及Status表关联配置方案

问题场景 #

现有数据库包含Companies、Customers、Status三张表，需要配置EF Core实体类的导航属性，实现查询Companies或Customers时能获取关联Status表的Name字段。

初始实体模型代码如下：

[Table("Companies")]
public class CompanyEntity
{
    [Key]
    public int Id { get; set; }

    public string Name { get; set; }

    public int Status_Id { get; set; }

    public DateTime Created_Date { get; set; }

    public DateTime Updated_Date { get; set; }

    [ForeignKey("Status_Id")]
    public Status Status { get; set; }
}

[Table("Customers")]
public class CustomerEntity
{
    [Key]
    public int Id { get; set; }

    public string Name { get; set; }
    public int Status_Id { get; set; }
}

[Table("Status")]
public class Status
{
    [Key]
    public int Id { get; set; }

    public string Name { get; set; }

    public CompanyEntity Company { get; set; }
}

初始问题：执行_dbContext.Companies.ToList()查询时，Status导航属性始终为NULL，无法获取状态信息。

中间错误尝试 #

尝试在OnModelCreating中添加如下配置后，Status不再为NULL，但关联逻辑错误——EF Core错误地使用Company的Id而非Status_Id建立关联：

modelBuilder.Entity<CompanyEntity>()
    .HasOne<Status>()
    .WithMany()
    .HasForeignKey(p => p.Status_Id);

移除该配置后，Status又变回NULL。

最终修复方案 #

通过两步调整彻底解决问题：

1. 修正Status实体的导航属性 #

Status与CompanyEntity是一对多关系（一个状态对应多个公司），因此需要将Status中的单个实体导航属性改为集合类型：

[Table("Status")]
public class Status
{
    [Key]
    public int Id { get; set; }

    public string Name { get; set; }

    // 从单个实体改为集合，匹配一对多关系
    public List<CompanyEntity> Companies { get; set; }
}

2. 查询时显式包含导航属性 #

EF Core默认不会自动加载导航属性（除非开启懒加载），因此查询时必须使用Include方法显式指定要加载的关联实体：

// 查询Companies并关联Status
var companies = _dbContext.Companies
    .Include(c => c.Status)
    .ToList();

补充：Customers实体的完善 #

如果需要查询Customers时也关联Status，需要给CustomerEntity添加对应的导航属性：

[Table("Customers")]
public class CustomerEntity
{
    [Key]
    public int Id { get; set; }

    public string Name { get; set; }
    public int Status_Id { get; set; }

    // 添加Status导航属性
    [ForeignKey("Status_Id")]
    public Status Status { get; set; }
}

同时在Status实体中添加对应的Customers集合：

[Table("Status")]
public class Status
{
    [Key]
    public int Id { get; set; }

    public string Name { get; set; }

    public List<CompanyEntity> Companies { get; set; }
    // 添加Customers集合
    public List<CustomerEntity> Customers { get; set; }
}

查询Customers时同样使用Include：

var customers = _dbContext.Customers
    .Include(c => c.Status)
    .ToList();

修复原理 #

• 导航属性的类型必须匹配数据库关系：Status对应多个Company/Customer，因此必须用集合类型，否则EF Core会误判为一对一关系，导致关联键匹配错误。
• EF Core的显式加载（Include）是获取关联实体的标准方式，除非开启懒加载（需额外配置，且有性能开销），否则不会自动加载导航属性。

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