.NET API中EF Include关联数据未加载问题排查与解决

问题 #

我有一个数据完整的数据库，其中reviewer表与review表为一对多关系。用.NET API编写了两段根据ID查询reviewer的代码，逻辑一致但返回结果不同：

代码(1) #

var reviewer =  _context.Reviewers.Where(r => r.Id == id).Include(e => e.Reviews).FirstOrDefault(); 
return Ok(reviewer); 

返回结果：

{   "id": 1,   "firstName": "Teddy",   "lastName": "Smith",   "reviews": null }

代码(2) #

var reviewer =  _context.Reviewers.Where(r => r.Id == id).Include(e => e.Reviews).FirstOrDefault();
var x = _context.Reviews.ToList();
return Ok(reviewer); 

返回结果：

{"id": 1,"firstName": "Teddy","lastName": "Smith","reviews": [{"id": 1,"title": "Pikachu","text": "Pickahu is the best pokemon, because it is electric","rating": 5,"reviewer": null,"pokemon": null}]}

仅代码(2)多执行了一次reviews表查询，为何代码(1)无法获取reviews数据？该如何修复？

模型定义如下：

Reviewer模型

namespace i1_start.Models
{
    public class Reviewer
    {
        public int Id { get; set; }
        public string FirstName { get; set; }
        public string LastName { get; set; }
        public ICollection<Review> Reviews {get; set;}
    }
}

Review模型

namespace i1_start.Models
{
    public class Review
    {
        public int Id { get; set; }
        public string Title { get; set; }
        public string Text { get; set; }
        public int Rating { get; set; }
        public Reviewer Reviewer { get; set; }
        public Pokemon Pokemon { get; set; }
    }
}

原因分析 #

• EF Core关系映射不明确：Review模型仅定义了导航属性Reviewer，但未显式声明对应的外键字段。EF Core无法自动识别一对多关系的关联规则，导致Include(e => e.Reviews)无法正确加载关联数据。
• 代码(2)的特殊情况：执行_context.Reviews.ToList()时，EF Core会将所有Review数据加载到上下文缓存中，随后通过关系修复机制自动将缓存中的Review关联到对应的Reviewer对象，因此返回结果能显示reviews数据。

修复方案 #

方式1：显式添加外键字段 #

在Review模型中添加对应Reviewer的外键字段，让EF Core明确关联关系：

namespace i1_start.Models
{
    public class Review
    {
        public int Id { get; set; }
        public string Title { get; set; }
        public string Text { get; set; }
        public int Rating { get; set; }
        // 添加外键字段，与导航属性Reviewer关联
        public int ReviewerId { get; set; }
        public Reviewer Reviewer { get; set; }
        public Pokemon Pokemon { get; set; }
    }
}

添加后重新生成迁移并更新数据库，代码(1)即可正确加载reviews数据。

方式2：用Fluent API配置关系 #

若不想修改模型，可在DbContext的OnModelCreating方法中通过Fluent API明确配置一对多关系：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Review>()
        .HasOne(r => r.Reviewer)
        .WithMany(r => r.Reviews)
        .HasForeignKey("ReviewerId"); // 指定数据库中对应的外键列名
}

需确保数据库Review表存在ReviewerId外键列，若不存在则需生成迁移更新数据库。

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