使用Entity Framework Core查询时遇无效列Id错误的解决方法

问题根源：EF Core 默认会把基类中的Id属性映射为数据库表的Id列，但你的Employee表主键列是EmployeeId，导致查询时EF尝试读取不存在的Id列，触发"Invalid column name 'Id'"错误。以下是几种实用的解决方式：

方法1：通过Fluent API单独配置实体映射 #

在你的DbContext中重写OnModelCreating方法，针对Employee实体明确指定主键列名：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Employee>(entity =>
    {
        // 将基类的Id属性设为当前实体的主键
        entity.HasKey(e => e.Id);
        // 映射到数据库的EmployeeId列
        entity.Property(e => e.Id).HasColumnName("EmployeeId");
        
        // 若CreatedDate、UpdatedDate列名与属性名一致，无需额外配置
    });
}

这种方式适合需要精细化控制单实体映射的场景，每个主键列名不同的实体都可单独配置。

方法2：用数据注解在派生类中重定义Id属性 #

如果偏好数据注解，可以在Employee类中用new关键字重定义Id属性，并通过[Column]特性指定对应数据库列名：

public class Employee : BaseEntity
{
    [Column("EmployeeId")]
    public new int Id { get; set; } // 类型需与基类Id保持一致
    public string Name { get; set; }
}

这种方式代码更简洁，适合快速配置单个实体。

方法3：泛型基类+批量配置（多实体场景） #

如果项目中有大量类似实体（如Customer对应CustomerId、Order对应OrderId），可以通过泛型基类配合批量配置减少重复代码：

步骤1：定义泛型基类 #

public class BaseEntity<TKey> : IBaseEntity
{
    public TKey Id { get; set; }
    public DateTime CreatedDate { get; set; }
    public DateTime UpdatedDate { get; set; }
}

// Employee继承泛型基类
public class Employee : BaseEntity<int>
{
    public string Name { get; set; }
}

步骤2：在DbContext中批量配置 #

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 遍历所有继承自BaseEntity<TKey>的实体类型
    foreach (var entityType in modelBuilder.Model.GetEntityTypes()
        .Where(t => t.ClrType.IsGenericType && t.ClrType.GetGenericTypeDefinition() == typeof(BaseEntity<>)))
    {
        // 拼接主键列名：实体类名 + Id（如Employee → EmployeeId）
        var primaryKeyColumnName = $"{entityType.ClrType.Name}Id";
        // 统一配置主键列映射
        modelBuilder.Entity(entityType.ClrType)
            .Property("Id")
            .HasColumnName(primaryKeyColumnName);
    }
}

这种方式只需一次配置，就能自动适配所有符合"实体类名+Id"规则的主键列。

内容的提问来源于stack exchange，提问作者I Love Stackoverflow