EntityFramework Core迁移异常：新增字段未同步至数据库且迁移文件错误

问题现象 #

在.NET控制台项目中使用EntityFramework Core，给Book模型新增Genre、Author、Publisher导航属性后，执行迁移操作出现异常：

• 生成的迁移文件逻辑错误：尝试重新创建数据库中已存在的Authors、Genres、Publishers表，未对Books表添加对应的外键关联字段
• 执行Update-Database时，程序包管理器控制台报错：There is already an object named 'Authors' in the database.

相关代码 #

Book模型类 #

public class Book
{
    public Guid Id { get; set; }
    public string? Title { get; set; }
    public int Pages { get; set; }
    public Genre? Genre { get; set; } // 新增导航属性
    public Author? Author { get; set; } // 新增导航属性
    public Publisher? Publisher { get; set; } // 新增导航属性
    public Guid GenreId { get; set; }
    public Guid AuthorId { get; set; }
    public Guid PublisherId { get; set; }
    public DateTime? PublishedDate { get; set; }
}

DbContext类 #

public class ApplicationContext : DbContext
{
    public DbSet<Book> Books { get; set; } = null!;
    public DbSet<Genre> Genres { get; set; } = null!;
    public DbSet<Author> Authors { get; set; } = null!;
    public DbSet<Publisher> Publishers { get; set; } = null!;

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        var builder = new ConfigurationBuilder();
        builder.SetBasePath(Directory.GetCurrentDirectory());
        builder.AddJsonFile("appsettings.json");
        var config = builder.Build();
        var connectionString = config.GetConnectionString("DefaultConnection");

        optionsBuilder.UseSqlServer(connectionString);
    }
}

错误的迁移文件核心片段 #

/// <inheritdoc />
public partial class NewBookFieldAdded : Migration
{
    /// <inheritdoc />
    protected override void Up(MigrationBuilder migrationBuilder)
    {
        // 错误：尝试创建数据库中已存在的Authors表
        migrationBuilder.CreateTable(
            name: "Authors",
            columns: table => new
            {
                Id = table.Column<Guid>(type: "uniqueidentifier", nullable: false),
                Name = table.Column<string>(type: "nvarchar(max)", nullable: true)
            },
            constraints: table =>
            {
                table.PrimaryKey("PK_Authors", x => x.Id);
            });

        // 省略Genres、Publishers表的重复创建代码...

        // 错误：尝试重新创建Books表，而非增量添加外键字段
        migrationBuilder.CreateTable(
            name: "Books",
            columns: table => new
            {
                Id = table.Column<Guid>(type: "uniqueidentifier", nullable: false),
                Title = table.Column<string>(type: "nvarchar(max)", nullable: true),
                Pages = table.Column<int>(type: "int", nullable: false),
                GenreId = table.Column<Guid>(type: "uniqueidentifier", nullable: false),
                AuthorId = table.Column<Guid>(type: "uniqueidentifier", nullable: false),
                PublisherId = table.Column<Guid>(type: "uniqueidentifier", nullable: false),
                PublishedDate = table.Column<DateTime>(type: "datetime2", nullable: true)
            },
            constraints: table =>
            {
                table.PrimaryKey("PK_Books", x => x.Id);
                // 省略外键约束代码...
            });
    }
}

问题原因 #

EF Core的迁移快照（YourDbContextModelSnapshot.cs）与数据库实际状态不一致，导致EF无法正确识别模型的增量变化：

• 错误判定Authors、Genres、Publishers表尚未创建
• 忽略了Books表需要新增外键字段的需求

常见触发场景：手动修改过数据库结构未同步迁移记录、迁移历史表__EFMigrationsHistory记录与本地迁移文件不匹配、迁移操作异常中断导致快照状态错乱。

解决方案 #

步骤1：清理错误迁移 #

1. 删除项目中生成的错误迁移文件（如NewBookFieldAdded.cs及对应设计文件）
2. 若该迁移已部分应用，执行Update-Database <上一个正常迁移的名称>回滚到正确状态

步骤2：对齐快照与数据库状态 #

如果数据库已包含Authors、Genres、Publishers表且结构与模型一致：

1. 执行命令生成空迁移，用于对齐快照与数据库：

   Add-Migration AlignDatabaseSnapshot -IgnoreChanges
   

2. 执行Update-Database将该空迁移记录到数据库迁移历史表

步骤3：生成正确的增量迁移 #

1. 确认模型中导航属性与外键配置无误（当前模型已满足要求）
2. 执行命令生成正确的增量迁移：

   Add-Migration AddBookForeignKeys
   

3. 检查迁移文件，确认内容为对Books表添加外键字段及约束（而非创建新表）
4. 执行Update-Database完成数据库更新

备选开发环境方案（数据可丢弃） #

1. 删除数据库中所有表（包括__EFMigrationsHistory）
2. 删除项目中所有已生成的迁移文件
3. 重新生成初始迁移并更新数据库：

   Add-Migration InitialCreate
   Update-Database
   

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