EF Core使用Include后SourceLines导航属性仍未加载关联实体

问题分析 #

你遇到的是EF Core继承场景下，Include关联的导航属性未加载的问题，结合你的代码和环境（EF Core 6.0.4 + MySQL），以下是针对性的排查和解决步骤：

解决方案 #

1. 修正继承策略配置（TPT模式）

你的SourceLine使用[Table("source_text")]指定单独表，属于**TPT（每个类型一张表）**继承策略，但父类Line未配置对应的表属性，导致EF Core无法正确识别表结构关联。

• 给父类Line添加[Table]属性：

[Table("lines")]
public class Line
{
    // 现有属性不变
}

• 在OnModelCreating中明确配置继承关系（可选，消除歧义）：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);

    // 配置TPT继承
    modelBuilder.Entity<Line>().ToTable("lines");
    modelBuilder.Entity<SourceLine>().ToTable("source_text");

    // 其他现有配置不变
}

2. 确保查询被实际执行

你的GetAll方法返回IEnumerable<File>，但EF Core的Include基于IQueryable延迟执行，若调用方未触发枚举（如ToList()/ToArray()），查询不会实际执行，导航属性自然不会被填充。

修改GetAll方法，强制立即执行查询：

public List<Models.Database.File> GetAll()
{
    return _dbContext.Files.Include(f => f.SourceLines).ToList();
}

或者返回IQueryable，让调用方控制执行时机：

public IQueryable<Models.Database.File> GetAll()
{
    return _dbContext.Files.Include(f => f.SourceLines);
}

3. 验证数据库外键与数据正确性

• 确认source_text表中存在file_id列（继承自Line类的FileId），且该列已建立指向files表的外键约束。
• 检查数据库中files表与source_text表的关联数据：确保存在file_id对应files.id的有效记录。

4. 排查全局查询过滤器

检查File或SourceLine的实体配置是否添加了HasQueryFilter，若存在过滤条件，可能导致关联数据被过滤，表现为导航属性为null：

// 示例：检查是否存在类似配置
modelBuilder.Entity<SourceLine>().HasQueryFilter(sl => sl.IsActive);

如有不必要的过滤器，可移除或调整逻辑。

5. 禁用延迟加载（若开启）

如果上下文启用了延迟加载代理（UseLazyLoadingProxies()），查询后上下文提前释放会导致导航属性因无法延迟加载变为null。可在上下文配置中显式禁用：

services.AddDbContext<LocDbContext>(options =>
    options.UseMySQL("connectionString")
           .UseLazyLoadingProxies(false));

验证方法 #

修改代码后，可通过日志查看EF Core生成的SQL语句，确认是否包含对source_text表的Join操作，以此判断Include是否生效。

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