为何EF Core中Include加载关联Hero失效？预加载Hero后恢复正常

这个问题的核心在于EF Core无法识别你的Guild和Hero之间的关联关系，以及EF的变更跟踪与关系修复机制在起作用，下面详细拆解：

为什么直接用Include加载Heroes为null？ #

你的实体定义里，Hero类没有任何指向Guild的外键或导航属性，EF Core无法自动推断出这两个实体之间存在一对多关系。这时候你写的Include(x => x.Heroes)实际上是无效的——EF不知道该怎么关联这两张表，自然不会加载关联数据，所以Guild的Heroes属性保持null。

为什么先查Heroes再查Guild就能加载数据？ #

当你执行_context.Heroes.ToList()时，EF会把所有Hero实体加载到变更跟踪器中。之后你查询Guild时，EF会检查变更跟踪器里已有的实体，结合数据库中实际存在的外键关系（虽然你没在实体里定义，但数据库里应该有GuildId外键吧？），自动完成关系修复：它会把所有属于该Guild的Hero实例，自动关联到Guild的Heroes集合里。这个过程是EF默认的行为，只要变更跟踪器处于启用状态（默认就是启用的）就会触发。

正确的解决方案：显式配置实体关系 #

要让Include正常工作，你需要明确告诉EF Core这两个实体的关联关系，最佳实践是添加外键和导航属性：

1. 更新实体定义 #

给Hero类添加外键和导航属性：

public class Hero : IEntity { 
    public int Id { get; set; } 
    public string FirstName { get; set; } 
    public string LastName { get; set; } 
    public string AvatarId { get; set; } 

    // 添加指向Guild的外键
    public int GuildId { get; set; }
    // 添加导航属性（可选，但推荐）
    public Guild Guild { get; set; }
} 

2. 配置关系（可选，但更清晰） #

你可以在TestContext的OnModelCreating方法里用Fluent API明确配置一对多关系，避免EF的自动推断出错：

public class TestContext : DbContext { 
    public TestContext(DbContextOptions options) : base(options) { } 
    public DbSet<Guild> Guilds { get; set; } 
    public DbSet<Hero> Heroes { get; set; } 

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        // 配置Guild和Hero的一对多关系
        modelBuilder.Entity<Guild>()
            .HasMany(guild => guild.Heroes) // Guild有多个Hero
            .WithOne(hero => hero.Guild)    // 每个Hero属于一个Guild
            .HasForeignKey(hero => hero.GuildId); // 外键是Hero.GuildId
    }
} 

做完这些配置后，再执行var guild = _context.Guilds.Include(x => x.Heroes).Single(x => x.Id == 1);，Guild的Heroes属性就会正常加载关联数据了，不需要先查询Heroes集合。

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