执行Asp.Net Identity迁移更新时遇'AspNetRoles已存在'错误

问题场景 #

我在Azure上部署了全新的SQL Server数据库，在Visual Studio for Mac终端执行以下EF Core命令：

dotnet ef migrations add "CreateProdAuthDatabase_PROD"
dotnet ef database update

执行时出现错误：

There is already an object named 'AspNetRoles' in the database.

迁移前已手动删除ApplicationDbContextModelSnapshot文件，该文件会在执行迁移命令时自动重新生成。相关代码文件包括：

• 生成后的ApplicationDbContextModelSnapshot代码
• 继承自IdentityUser的ApplicationUser类代码
• ApplicationDbContext类代码
• Program.cs中的关键配置代码

可能原因 #

• 数据库并非真正"全新"：Azure上的数据库可能之前被误执行过初始化命令、部署时自动运行了初始化逻辑，或是从备份恢复过，导致Identity相关表已存在。
• 迁移历史表不一致：本地删除ModelSnapshot后，数据库中的__EFMigrationsHistory表仍有迁移记录，EF Core判定对应迁移已执行，但重新生成的迁移又试图创建已存在的表。
• Identity服务重复注册：Program.cs中重复添加了Identity服务，导致EF Core生成的迁移包含重复的表创建逻辑。
• ModelSnapshot生成异常：删除后重新生成的ModelSnapshot未正确匹配当前实体模型，导致迁移逻辑与数据库实际状态冲突。

解决方案 #

方案1：清理数据库现有Identity表与迁移记录 #

1. 通过SSMS或Azure Portal查询编辑器连接目标数据库，执行以下SQL检查状态：

-- 检查Identity表是否存在
SELECT * FROM sys.tables WHERE name LIKE 'AspNet%';
-- 检查迁移历史记录
SELECT * FROM __EFMigrationsHistory;

2. 若存在相关表和记录，执行删除操作：

-- 删除Identity系列表
DROP TABLE IF EXISTS AspNetUserClaims;
DROP TABLE IF EXISTS AspNetUserLogins;
DROP TABLE IF EXISTS AspNetUserTokens;
DROP TABLE IF EXISTS AspNetUserRoles;
DROP TABLE IF EXISTS AspNetRoles;
DROP TABLE IF EXISTS AspNetUsers;
-- 删除迁移历史表
DROP TABLE IF EXISTS __EFMigrationsHistory;

3. 重新执行迁移命令：

dotnet ef migrations add "CreateProdAuthDatabase_PROD"
dotnet ef database update

方案2：重置本地迁移与数据库历史 #

1. 删除项目Migrations目录下的所有迁移文件。
2. 连接数据库，删除__EFMigrationsHistory表：

DROP TABLE IF EXISTS __EFMigrationsHistory;

3. 重新生成初始迁移并更新数据库：

dotnet ef migrations add InitialCreate_ProdAuth
dotnet ef database update

方案3：修正Identity服务配置 #

打开Program.cs，确保Identity服务仅注册一次，示例正确配置如下：

// 注册DbContext
builder.Services.AddDbContext<ApplicationDbContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection")));

// 注册Identity服务，仅调用一次
builder.Services.AddDefaultIdentity<ApplicationUser>(options => options.SignIn.RequireConfirmedAccount = true)
    .AddEntityFrameworkStores<ApplicationDbContext>();

避免重复调用AddDefaultIdentity或AddIdentity方法。

方案4：同步数据库状态（保留现有业务数据时使用） #

若数据库中已有需保留的业务数据，可通过空迁移同步状态：

1. 生成空迁移：

dotnet ef migrations add InitialSync_ProdAuth --empty

2. 打开生成的迁移文件，添加同步历史记录的SQL语句（替换迁移ID和EF版本为实际值）：

protected override void Up(MigrationBuilder migrationBuilder)
{
    migrationBuilder.Sql(@"INSERT INTO __EFMigrationsHistory (MigrationId, ProductVersion) VALUES ('202XXXXXXXXXX_InitialSync_ProdAuth', '7.0.0')");
}

3. 执行迁移更新：

dotnet ef database update

后续正常执行迁移命令时，EF Core会判定初始状态已同步，不会重复创建表。

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