EF Core 2 Code First迁移时外键列重复生成问题求助

我之前也碰到过类似EF Core约定冲突导致的列生成问题，结合你的实体代码来看，问题根源是EF Core无法正确识别导航属性对应的外键，再加上可能的配置残留或约定冲突，才生成了冗余的StoreId和带后缀的StoreId1外键列。下面是分步解决方法：

1. 修正实体模型：显式添加外键属性 #

EF Core默认遵循约定，但当没有显式外键属性时，有时会因为模型变更或配置模糊生成异常列。给StoreVisit添加显式外键并关联导航属性：

[Table("StoreVisit")]
public class StoreVisit
{
    [Key]
    public int StoreVisitId { get; set; }
    [StringLength(50)]
    public string Location { get; set; }
    [StringLength(50)]
    public string Notes { get; set; }
    [DataType(DataType.Time)]
    public DateTime StartTime { get; set; }
    [DataType(DataType.Time)]
    public DateTime EndTime { get; set; }

    // 新增显式外键属性
    public int StoreId { get; set; }

    // 用ForeignKey注解关联外键与导航属性
    [ForeignKey(nameof(StoreId))]
    public Store Store { get; set; }
}

同时建议把Store类的导航属性改成ICollection<T>（比IEnumerable<T>更适配EF Core的变更跟踪机制）：

[Table("Store")]
public class Store
{
    public Store()
    {
        StoreVisits = new HashSet<StoreVisit>();
    }
    // ... 其他属性保持不变

    // 修改为ICollection类型
    public ICollection<StoreVisit> StoreVisits { get; set; }
}

2. 清理现有迁移并重新生成（适合数据库未正式使用的场景） #

如果你的数据库还没有生产数据，可以直接清理旧迁移，重新生成正确的结构：

• 删除项目中Migrations文件夹下的所有迁移文件（保留DesignTimeDbContextFactory如果存在）
• 删除当前数据库（可通过SSMS或EF Core CLI操作）
• 执行迁移命令：
  • Package Manager Console：Add-Migration InitialCreate
  • .NET CLI：dotnet ef migrations add InitialCreate
• 更新数据库：
  • Package Manager Console：Update-Database
  • .NET CLI：dotnet ef database update

3. 修复现有数据库（适合已有数据的场景） #

如果不能删除数据库，需要生成一个迁移来修正列：

1. 先执行Add-Migration FixForeignKeyColumns生成新迁移
2. 打开生成的迁移文件，修改Up方法，删除冗余列并修正外键：

protected override void Up(MigrationBuilder migrationBuilder)
{
    // 删除冗余的非外键StoreId列
    migrationBuilder.DropColumn(
        name: "StoreId",
        table: "StoreVisit");

    // 将StoreId1重命名为正确的StoreId
    migrationBuilder.RenameColumn(
        name: "StoreId1",
        table: "StoreVisit",
        newName: "StoreId");

    // 确保外键约束正确（如果之前的约束有问题，重新创建）
    migrationBuilder.CreateIndex(
        name: "IX_StoreVisit_StoreId",
        table: "StoreVisit",
        column: "StoreId");

    migrationBuilder.AddForeignKey(
        name: "FK_StoreVisit_Store_StoreId",
        table: "StoreVisit",
        column: "StoreId",
        principalTable: "Store",
        principalColumn: "StoreId",
        onDelete: ReferentialAction.Cascade);
}

3. 执行Update-Database应用这个迁移，完成修复。

4. 可选：用Fluent API明确配置关系 #

为了彻底避免约定冲突，也可以在DbContext的OnModelCreating方法中用Fluent API配置关系：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<StoreVisit>()
        .HasOne(sv => sv.Store)
        .WithMany(s => s.StoreVisits)
        .HasForeignKey(sv => sv.StoreId); // 指定外键属性
}

这样EF Core会严格按照你的配置生成外键，不会再出现自动生成冗余列的问题。

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