EF .NET Core 2中MySQL的Include()方法无法加载关联数据

这种情况我碰到过好几次，大概率是实体关联配置或者查询细节出了问题，咱们一步步排查解决：

1. 先检查实体类与关联配置是否正确 #

EF Core的Include生效的前提是它能识别正确的关联关系，所以先确认你的实体定义和上下文配置：

实体类定义要匹配外键关系 #

比如你的Game和GameStats类应该类似这样：

public class Game
{
    public int GameId { get; set; }
    // 确保外键字段存在且名称正确
    public int GameStatsId { get; set; }
    // 导航属性要正确指向GameStats
    public GameStats GameStats { get; set; }
}

public class GameStats
{
    public int GameStatsId { get; set; }
    // 如果是一对多关系，加上对应的集合导航（一对一的话可以用单个Game属性）
    public ICollection<Game> Games { get; set; } = new List<Game>();
}

用Fluent API明确配置关联（关键！） #

很多时候自动映射会出错，最好在DbContext的OnModelCreating里显式定义关联：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 一对多场景：一个GameStats对应多个Game
    modelBuilder.Entity<Game>()
        .HasOne(g => g.GameStats)
        .WithMany(gs => gs.Games)
        .HasForeignKey(g => g.GameStatsId); // 明确指定外键字段

    // 如果是一对一关系，改成这样：
    // modelBuilder.Entity<Game>()
    //     .HasOne(g => g.GameStats)
    //     .WithOne(gs => gs.Game)
    //     .HasForeignKey<Game>(g => g.GameStatsId);
}

如果这里没指定正确的外键，EF Core可能找不到关联，自然不会生成JOIN语句。

2. 排查查询语句的干扰项 #

• 有没有用投影（Select）？ 如果Include之后又用了Select筛选字段，EF Core会忽略Include，比如这种写法就会失效：

  // 错误示例：Include被忽略
  var games = _context.Game.Include(g => g.GameStats)
                           .Select(g => new { g.GameId, g.GameStatsId })
                           .ToList();
  

  要确保查询没有做这类投影，或者在投影里明确包含导航属性。

• 有没有用AsNoTracking()？ 虽然它不直接影响Include，但如果上下文之前缓存了没有关联数据的Game实体，再次查询时会复用缓存。可以试试用全新的上下文实例，或者在查询时加AsNoTracking()强制获取新数据。

3. 排除其他低级错误 #

• 检查GameStats导航属性有没有被标记[NotMapped]，如果有，EF Core会忽略这个属性，Include自然无效。
• 试试用字符串形式的Include：_context.Game.Include("GameStats").ToList()，如果这个能生效，说明lambda表达式可能有拼写错误或者命名空间冲突。

4. 升级EF Core版本 #

如果你用的是2.x及以下的旧版本，可能存在Include的已知bug，建议升级到最新的稳定版本（比如6.x或7.x），很多旧问题在新版本里已经修复了。

按照上面的步骤排查，基本就能解决Include不加载关联数据的问题了。

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