EF Core 3.1为实体自动添加额外列引发查询失败如何解决

问题原因确认 #

你观察到的EF Core自动生成ClientRequestSearchPartialClientRequestId列的行为，确实是ClientRequestSearchPartial上的List<ClientRequestDetails>导航属性触发的。

EF Core默认内置一对多关联的约定规则：当主体实体（此处为ClientRequestSearchPartial）定义了指向从属实体（此处为ClientRequestDetails）的集合导航属性，但未显式配置外键关联规则时，EF Core会自动按照[主体实体类名]+[主体实体主键名]的格式，在从属实体上生成隐式外键列，哪怕主体实体没有对应数据库表，该约定也会被触发。

解决方案 #

根据你的场景（ClientRequestSearchPartial为无数据库表的虚拟实体，仅手动构造使用），优先推荐第一种方案：

方案1：将虚拟实体排除出EF Core模型映射（最优解）

直接在DbContext的OnModelCreating方法中，将ClientRequestSearchPartial标记为EF Core不需要扫描的类型，从根源上避免关联规则触发，完全不会影响你手动构造该实体的逻辑：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 完全排除该实体的映射，不会触发任何关联规则扫描
    modelBuilder.Ignore<ClientRequestSearchPartial>();
}

方案2：标记导航属性为非映射（次选）

如果你需要保留ClientRequestSearchPartial在EF Core的模型中，可以单独标记集合导航属性不参与映射：

• 方式一：使用特性标记

public class ClientRequestSearchPartial
{
    public int ClientRequestId { get; set; }
    [NotMapped]
    public List<ClientRequestDetails> ClientRequestDetails { get; set; }
}

• 方式二：使用Fluent API配置

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<ClientRequestSearchPartial>()
        .Ignore(x => x.ClientRequestDetails);
}

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