Entity Framework查询时外键关联导航属性返回NULL问题咨询

Entity Framework 默认不会自动填充实体的导航关联属性，你查询到的Author为null是因为没有显式指定要加载关联的作者数据，和插入流程、数据库外键配置没有关系，按需选择下面三种加载方案即可解决。

方案1：预加载（推荐，性能可控） #

这是日常开发最常用的方案，查询主数据时通过Include方法同步指定要加载的关联属性，一次SQL查询就会把主表和关联表的数据查出来，不会产生多余查询。
你只需要修改查询代码即可：

// 必须引入以下命名空间，否则无法使用Include方法
using Microsoft.EntityFrameworkCore;

BookModel book = _db.books
    .Include(book => book.Author) // 指定同步加载作者导航属性
    .FirstOrDefault(b => b.Id == 1);

如果需要加载多层嵌套的关联数据，可以在Include之后链式调用ThenInclude方法继续指定下一层关联。

方案2：懒加载（自动加载，谨慎使用） #

配置懒加载后，当你代码访问到Author属性时，EF会自动发送SQL查询加载对应作者数据，不需要在查询时手动写Include，但这种方式很容易产生N+1查询问题（比如遍历100条图书数据时，会额外发送100次查询作者的请求，性能很差），只适合小数据量场景使用。
配置步骤：

• 给项目安装NuGet包Microsoft.EntityFrameworkCore.Proxies
• 在DbContext配置中启用懒加载代理：

  protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
  {
      optionsBuilder
          .UseLazyLoadingProxies() // 启用懒加载代理
          .UseSqlServer("你的数据库连接字符串");
  }
  

• 给所有需要懒加载的导航属性添加virtual修饰符：

  public class BookModel
  {
      public int Id { get; set; }
      public string Title { get; set; }
      public string Description { get; set; }
      public int Pages { get; set; }
      // 加virtual修饰以支持懒加载代理
      public virtual AuthorModel Author { get; set; }
  }
  

配置完成后你原来的查询代码不需要任何修改，访问book.Author时会自动填充数据。

方案3：显式加载（适合临时补载关联数据） #

如果主实体已经查询完成，后续临时需要加载关联数据，可以用显式加载的方式，不需要重新查询主实体：

// 先查图书数据
BookModel book = _db.books.FirstOrDefault(b => b.Id == 1);

// 后续需要用到作者数据时，手动加载关联
_db.Entry(book)
    .Reference(b => b.Author)
    .Load();

最佳实践 #

建议在BookModel中显式定义外键字段AuthorId，EF会自动识别外键和导航属性的映射关系，避免隐式外键带来的映射异常，修改后的实体如下：

public class BookModel
{
    public int Id { get; set; }
    public string Title { get; set; }
    public string Description { get; set; }
    public int Pages { get; set; }
    // 显式定义外键字段，类型和AuthorModel的主键类型一致
    public int AuthorId { get; set; }
    public AuthorModel Author { get; set; }
}

你之前的插入逻辑不需要调整，EF保存数据时会自动把新生成的作者ID赋值给AuthorId字段，关联映射会更稳定。

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