ASP.NET Core Identity迁移PostgreSQL报错：AspNetRoles已存在

你遇到的Npgsql.PostgresException: '42P07: relation "AspNetRoles" already exists'异常，本质是EF Core执行MigrateAsync时尝试重复创建已存在的AspNetRoles表，常见原因和解决步骤如下：

1. 检查迁移执行记录 #

查看数据库中的__EFMigrationsHistory表，确认所有迁移脚本是否都已成功记录：

• 若某条已执行的迁移未被记录，EF Core会重复执行该迁移，导致表重复创建报错。
• 确认迁移已执行但未记录的话，可手动插入对应的迁移ID和执行时间到__EFMigrationsHistory（操作前请备份数据库）。

2. 排查重复的迁移文件 #

检查项目中Migrations目录下的迁移文件：

• 确认是否存在重复创建AspNetRoles表的代码，比如手动添加过创建该表的迁移，同时Identity默认迁移也包含该表创建逻辑。
• 自动生成的Identity迁移文件，不要手动修改添加重复的表创建语句。

3. 避免迁移逻辑重复执行 #

确保MigrateAsync代码仅执行一次：

• 检查Program.cs启动逻辑，是否存在多次调用MigrateAsync的情况（比如被多个服务注入或中间件重复触发）。
• 多实例部署场景下，不要让多个服务实例同时执行迁移，建议单独通过CLI命令dotnet ef database update执行迁移，或用分布式锁控制迁移执行。

4. 适配PostgreSQL表名大小写规则 #

PostgreSQL默认区分表名大小写，EF Core生成的Identity表名（如AspNetRoles）可能和数据库实际存储的小写表名冲突，导致EF Core误判表不存在并重复创建：
在ApplicationDbContext的OnModelCreating方法中统一表名为小写：

protected override void OnModelCreating(ModelBuilder builder)
{
    base.OnModelCreating(builder);
    // 将所有表名转为小写，适配PostgreSQL默认行为
    foreach (var entityType in builder.Model.GetEntityTypes())
    {
        entityType.SetTableName(entityType.GetTableName().ToLower());
    }
}

5. 手动修复（谨慎操作） #

若确认所有表已正常创建、迁移记录无误但仍报错：

• 可暂时注释Program.cs中的MigrateAsync调用，改用CLI命令dotnet ef database update执行迁移，之后再恢复代码（确保后续不会重复触发）。

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