如何让Microsoft.AspNetCore.Identity兼容Microsoft.AspNet.Identity数据库

我之前帮不少开发者处理过从传统ASP.NET MVC Identity迁移到.NET Core Identity的问题，结合你还要搭建PWA的需求，给你整理一套可行的解决方案：

原来的Microsoft.AspNet.Identity和.NET Core的Microsoft.AspNetCore.Identity在身份模型的数据库Schema上有不少细微差异：

• 新增字段：比如AspNetUsers表多了ConcurrencyStamp（用于并发控制）
• 字段类型调整：SecurityStamp从nvarchar(max)改成了nvarchar(450)
• 部分关联表的约束或字段长度有变化，比如AspNetUserClaims里的Claim字段长度限制

这些差异直接导致Core的Identity无法直接读取旧数据库的数据。

1. 手动修改现有数据库Schema（最快的临时方案） #

如果不想重新建库，直接在原有数据库上调整字段就能适配Core Identity：

• 先备份数据库！先备份数据库！先备份数据库！重要的事说三遍
• 执行以下SQL脚本补全字段和调整类型：

  -- 给AspNetUsers添加ConcurrencyStamp字段（Core Identity必填）
  ALTER TABLE AspNetUsers ADD ConcurrencyStamp NVARCHAR(450) NULL;
  -- 调整SecurityStamp字段长度匹配Core要求
  ALTER TABLE AspNetUsers ALTER COLUMN SecurityStamp NVARCHAR(450) NULL;
  -- 如果有自定义用户字段，确保类型和Core模型一致
  

• 测试：启动Core项目，配置Identity连接到修改后的数据库，验证登录、注册功能是否正常

2. 用EF Core迁移工具适配（最规范的长期方案） #

适合需要后续持续迭代Identity功能的场景：

• 创建.NET Core MVC/Razor Pages项目，引入Microsoft.AspNetCore.Identity.EntityFrameworkCore和Microsoft.EntityFrameworkCore.SqlServer
• 自定义Identity模型类，匹配你原有数据库的字段（比如原有用户表有FullName，就继承IdentityUser添加该属性）：

  public class CustomUser : IdentityUser
  {
      public string FullName { get; set; }
      // 其他自定义字段...
  }
  

• 配置DbContext继承IdentityDbContext<CustomUser>：

  public class AppDbContext : IdentityDbContext<CustomUser>
  {
      public AppDbContext(DbContextOptions<AppDbContext> options) : base(options) { }
      // 其他DbSet...
  }
  

• 在Program.cs中注册Identity和DbContext：

  builder.Services.AddDbContext<AppDbContext>(options =>
      options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection")));
  builder.Services.AddIdentity<CustomUser, IdentityRole>()
      .AddEntityFrameworkStores<AppDbContext>()
      .AddDefaultTokenProviders();
  

• 生成初始迁移（忽略现有数据库的差异，把当前状态设为基线）：

  Add-Migration InitialCreate -IgnoreChanges
  Update-Database
  

• 之后如果需要新增字段或修改模型，直接正常生成迁移即可，EF Core会自动同步数据库

3. 全量迁移数据到新数据库（最安全的隔离方案） #

如果不想动原数据库，可以写一个小工具同步数据：

• 新建Core Identity数据库，用EF Core生成标准Schema
• 编写数据同步逻辑，把旧数据库的用户、角色、Claims等数据导入新库
• 注意：密码哈希是兼容的！AspNet.Identity和AspNetCore.Identity都用PBKDF2算法，直接迁移PasswordHash字段即可
• 同步时要注意字段类型匹配，比如SecurityStamp要转成nvarchar(450)

解决完Identity兼容问题后，就可以正常搭建PWA了：

• 可以用WebEssentials.AspNetCore.PWA NuGet包快速生成manifest.json和service-worker，或者手动配置
• 确保身份验证Cookie支持HTTPS（生产环境必须），并设置合适的SameSite属性，避免PWA的离线或跨域问题：

  builder.Services.ConfigureApplicationCookie(options =>
  {
      options.Cookie.SameSite = SameSiteMode.Lax;
      options.Cookie.SecurePolicy = CookieSecurePolicy.Always;
  });
  

• 用Microsoft.AspNetCore.Identity.UI快速生成响应式的登录/注册页面，适配PWA的移动端体验

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