.NET EF Core迁移报错：无法找到Document<FinancialReport>.Tags的字段_tags

错误根源 #

你遇到的问题有两个核心原因：

1. _tags是私有属性而非字段：你的代码里把_tags定义成了带getter/setter的私有属性（private string? _tags { get; set; }），但EF Core的HasField方法要求指向的是字段（field），不是属性（property）。
2. 后备字段位于基类，配置时未正确关联：_tags定义在泛型基类DocumentBase<T>中，直接针对派生类Document<FinancialReport>配置时，EF Core无法自动识别基类的私有字段。

修正方案 #

步骤1：将_tags改为私有字段 #

修改基类DocumentBase<T>的代码，把_tags从私有属性改为私有字段：

public class DocumentBase<T>
{
    // 改为私有字段，去掉getter/setter
    private string? _tags;

    public int Id { get; set; }

    [NotMapped]
    public string[] Tags
    {
        get { return _tags?.Split(',') ?? Array.Empty<string>(); }
        set { _tags = value?.Any() ?? false ? string.Join(",", value) : null; }
    }

    public T? Data { get; set; }
}

步骤2：正确配置基类的后备字段 #

有两种可选方式配置，选其中一种即可：

方式1：使用特性配置（推荐）

直接在基类的Tags属性上添加[BackingField]特性，指定后备字段名称：

public class DocumentBase<T>
{
    private string? _tags;

    public int Id { get; set; }

    [NotMapped]
    [BackingField("_tags")] // 添加该特性关联后备字段
    public string[] Tags
    {
        get { return _tags?.Split(',') ?? Array.Empty<string>(); }
        set { _tags = value?.Any() ?? false ? string.Join(",", value) : null; }
    }

    public T? Data { get; set; }
}

此时可以移除OnModelCreating中针对Tags的配置，EF Core会自动识别基类的后备字段。

方式2：在OnModelCreating中显式配置基类字段

如果不想用特性，直接配置基类的私有字段映射到数据库：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Document<FinancialReport>>()
        .Property<string>("_tags") // 直接配置基类的私有字段
        .HasColumnName("Tags"); // 指定数据库中对应的列名
}

这种方式下，Tags属性保持[NotMapped]标记，无需再通过它配置映射。

验证步骤 #

1. 删除之前生成的无效迁移文件（如果存在）
2. 执行Add-Migration命令重新生成迁移
3. 执行Update-Database验证迁移是否正常运行

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