EF Core无法识别Company实体已删除的PdfTemplateId列问题

问题核心 #

从Company实体中删除PdfTemplateId列及对应导航属性后，EF Core无法识别该列已删除，执行add-migration无变更；后续尝试修改时出现异常迁移结果：生成阴影属性PdfTemplateId1、自动创建未定义的中间表CompanyPdfTemplate。

问题根源分析 #

1. 关系配置不匹配：PdfTemplateConfiguration中配置了HasOne(t => t.Company).WithMany(c => c.PdfTemplates)，但Company实体中并未定义PdfTemplates集合属性，导致EF Core关系推断混乱。
2. 残留多对多关系推断：PdfTemplate实体中保留了ICollection<Company> Companies集合属性，EF Core会自动将其推断为多对多关系，从而生成中间表。
3. 模型快照残留旧配置：ApplicationDbContextModelSnapshot中仍保留PdfTemplateId的属性定义，导致迁移生成逻辑异常。

排查与修复步骤 #

1. 清理实体及配置中的无效关系 #

修正PdfTemplate实体

删除多余的Companies集合属性（若无需多对多关系）：

public class PdfTemplate
{
    // 原有属性保持不变...

    public ICollection<PurchaseOrder> PurchaseOrders { get; set; }
    public ICollection<PdfTemplateField> PdfTemplateFields { get; set; }
    // 删除以下无效集合属性
    // public ICollection<Company> Companies { get; set; }
}

修正PdfTemplateConfiguration

调整关系配置，匹配实际实体结构：

public class PdfTemplateConfiguration : IEntityTypeConfiguration<PdfTemplate>
{
    public void Configure(EntityTypeBuilder<PdfTemplate> builder)
    {
        // 由于Company中无对应PdfTemplates集合，使用无参数的WithMany()
        builder.HasOne(t => t.Company)
            .WithMany()
            .OnDelete(DeleteBehavior.NoAction);

        // 其他原有配置保持不变...
    }
}

2. 重置模型快照（必要时） #

手动清理ApplicationDbContextModelSnapshot中Company实体的旧配置：

// 删除以下PdfTemplateId相关代码
b.Property<int?>("PdfTemplateId")
    .HasColumnType("int");

b.HasIndex("PdfTemplateId");

3. 重新生成并执行迁移 #

1. 删除之前生成的异常迁移文件（如修改可空性、生成阴影属性的迁移）。
2. 生成新迁移：

add-migration RemovePdfTemplateIdFromCompany

3. 检查迁移代码，确认包含DropColumn和DropForeignKey操作后，执行数据库更新：

update-database

4. 验证结果 #

执行迁移后，检查数据库中Companies表的PdfTemplateId列是否已删除，同时确认无自动生成的中间表。

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