EF Core 6使用Include()关联查询后关联字段为null的问题

核心原因 #

你的Include未生效主要源于两个关键问题：

• 实体关系被重复配置，导致EF Core的映射逻辑出现冲突
• 未显式定义外键字段，EF Core自动生成的隐式外键可能与数据库实际列名不匹配，关联失败

修复步骤 #

1. 移除重复的关系配置 #

LanguageConfiguration和CourseConfiguration中重复定义了同一组一对多关系，EF Core处理重复配置时会出现异常，需删除LanguageConfiguration中的关系配置：

public class LanguageConfiguration : IEntityTypeConfiguration<Language>
{
    public void Configure(EntityTypeBuilder<Language> builder)
    {
        // 仅保留Language实体的基础配置（如索引、字段校验等），删除以下两行重复配置
        // builder.HasMany(l => l.CoursesFrom).WithOne(c => c.LanguageFrom);
        // builder.HasMany(l => l.CoursesTo).WithOne(c => c.LanguageTo);
    }
}

2. 给Course实体添加显式外键字段 #

在Course类中添加对应外键属性，确保EF Core能精准识别关联关系：

public class Course
{
    [Key]
    public long Id { get; set; }
    public string PublicId { get; set; }
    public string Name { get; set; }

    // 新增显式外键（允许null，对应OnDelete(SetNull)配置）
    public long? LanguageFromId { get; set; }
    public long? LanguageToId { get; set; }

    public virtual Language LanguageFrom { get; set; }
    public virtual Language LanguageTo { get; set; }
}

3. 配置Course时明确指定外键 #

修改CourseConfiguration，显式绑定导航属性与外键字段：

public class CourseConfiguration : IEntityTypeConfiguration<Course>
{
    public void Configure(EntityTypeBuilder<Course> builder)
    {
        // ...其他基础配置

        builder.HasOne(c => c.LanguageFrom)
               .WithMany(l => l.CoursesFrom)
               .HasForeignKey(c => c.LanguageFromId) // 显式指定外键
               .OnDelete(DeleteBehavior.SetNull);

        builder.HasOne(c => c.LanguageTo)
               .WithMany(l => l.CoursesTo)
               .HasForeignKey(c => c.LanguageToId) // 显式指定外键
               .OnDelete(DeleteBehavior.SetNull);
    }
}

4. 校验数据库列名匹配 #

确保PostgreSQL中Course表的外键列名与实体外键字段一致（例如实体LanguageFromId对应数据库的language_from_id，若不一致可通过HasColumnName指定）：

// 示例：适配PostgreSQL的小写蛇形命名规范
builder.Property(c => c.LanguageFromId)
       .HasColumnName("language_from_id");
builder.Property(c => c.LanguageToId)
       .HasColumnName("language_to_id");

5. 重新执行查询 #

完成上述调整后，原查询即可正常加载关联的Language实体：

var query = Context.Course
                .Include(c => c.LanguageFrom)
                .Include(c => c.LanguageTo)
                .ToList();

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