为什么ChangeTracker.Load()无法加载所有关联的导航属性？

问题原因分析 #

1. 直接调用Collection(x => x.JobCategories).Load()无法填充子导航属性
   EF Core的显式加载默认只会加载当前层级的实体，也就是只会加载CompanyJobCategory集合，不会自动递归加载其下的JobCategory导航属性，这是框架默认的性能保护机制，避免不必要的关联查询和递归加载风险。

2. 部分JobCategory偶尔有值的原因
   这是EF Core内置的导航属性自动修复机制导致的：如果某个JobCategory实体此前已经被当前DbContext实例跟踪过（比如其他业务逻辑提前查询过对应ID的分类数据），EF Core会自动将同主键的跟踪实体关联到CompanyJobCategory.JobCategory属性上；没有被跟踪过的实体就会保持null值，所以会出现部分加载、部分未加载的随机现象。

3. 加了Include之后仍有部分null的可能原因

• 对应JobCategoryId在JobCategory表中没有匹配的主键记录，如果数据库没有设置外键约束，这种情况是合法存在的
• 部分CompanyJobCategory是当前事务内新增的、还未调用SaveChanges()提交到数据库的记录，Query()方法是直接查询数据库，不会读取上下文本地新增的未提交数据
• 你配置了全局查询过滤器（比如软删除过滤、租户过滤），符合过滤条件的JobCategory会被自动排除在查询结果之外

解决方案 #

场景1：所有CompanyJobCategory都已持久化到数据库 #

调整显式加载的写法即可完整加载所有关联数据：

var jobCategoryCollection = entry.Collection(x => x.JobCategories);
// 重置加载状态，避免EF认为已经加载过就跳过查询
jobCategoryCollection.IsLoaded = false;
// 显式指定要包含的子导航属性后再执行加载
jobCategoryCollection
    .Query()
    .Include(y => y.JobCategory)
    .Load();

场景2：存在未提交的新增CompanyJobCategory记录 #

这时候需要先批量加载所有关联的JobCategory到上下文，利用EF的自动修复机制填充导航属性：

// 收集所有需要加载的分类ID
var requiredJobCategoryIds = entry.Entity.JobCategories
    .Select(c => c.JobCategoryId)
    .Distinct()
    .ToList();

// 批量加载所有对应分类到上下文
DbContext.Set<JobCategory>()
    .Where(j => requiredJobCategoryIds.Contains(j.Id))
    .Load();

// 加载完成后EF会自动将所有匹配的JobCategory赋值到对应的导航属性上

额外排查项 #

• 确认实体配置中已经正确将CompanyJobCategory.JobCategoryId配置为关联JobCategory主键的外键
• 排查是否有全局查询过滤器、查询拦截器等逻辑过滤了JobCategory的查询结果
• 确认返回null的JobCategory对应的JobCategoryId在数据库中确实存在有效记录

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