ASP.NET Core 8迁移时AspNetUserRoles表数据丢失如何保留？

问题原因 #

EF Core迁移处理Identity的AspNetUserRoles连接表时，若迁移文件生成了重建表（先删后建）的操作，就会导致原有数据丢失。这种情况通常出现在修改User/Role实体配置、或者EF自动检测表结构变更时误生成重建逻辑。

解决方案 #

1. 手动清理迁移文件中的危险操作 #

执行dotnet ef migrations add updateUserTable后，先打开Migrations文件夹下刚生成的迁移文件（文件名格式如YYYYMMDDHHMMSS_updateUserTable.cs）：

• 检查Up()方法中是否包含针对AspNetUserRoles的DropTable、CreateTable或批量删除数据的代码
• 直接删除这些会清空/重建表的代码块，只保留你需要的User表更新操作（比如添加列、修改列属性等）
• 确认无误后再执行dotnet ef database update

2. 确认Identity实体的配置正确性 #

如果自定义了UserRole实体，确保DbContext中的配置没有破坏连接表的复合主键逻辑：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);

    // 自定义UserRole时必须明确配置复合主键
    modelBuilder.Entity<ApplicationUserRole>(ur =>
    {
        ur.HasKey(r => new { r.UserId, r.RoleId });
    });
}

错误的主键配置会让EF误认为表结构需要完全重建，进而清空数据。

3. 若需修改连接表结构，手动备份恢复数据 #

如果确实要修改AspNetUserRoles的表结构（比如新增列），不要依赖EF自动生成的操作，而是在迁移中手动备份并恢复数据：

public override void Up()
{
    // 1. 备份数据到临时表
    Sql("SELECT * INTO AspNetUserRoles_Backup FROM AspNetUserRoles");

    // 2. 执行你的表结构修改操作（示例：新增列）
    AddColumn("dbo.AspNetUserRoles", "CreatedAt", c => c.DateTimeOffset(nullable: false, defaultValueSql: "GETUTCDATE()"));

    // 3. 从临时表恢复数据
    Sql("INSERT INTO AspNetUserRoles (UserId, RoleId, CreatedAt) SELECT UserId, RoleId, GETUTCDATE() FROM AspNetUserRoles_Backup");

    // 4. 删除临时表
    Sql("DROP TABLE AspNetUserRoles_Backup");
}

4. 排查项目中的数据库初始化逻辑 #

检查Program.cs或启动类中，是否存在会重置数据库的代码：

• 禁用Database.EnsureCreated()，该方法会直接创建全新数据库，覆盖现有数据
• 确保使用Database.Migrate()来执行迁移：

var scope = app.Services.CreateScope();
var dbContext = scope.ServiceProvider.GetRequiredService<ApplicationDbContext>();
dbContext.Database.Migrate(); // 正确的迁移执行方式

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