如何在.NET 6.0 Web API中兼容旧ASP.NET MVC5 Identity实现用户鉴权

核心矛盾是ASP.NET Identity 不同版本的密码哈希格式不兼容，MVC5（ASP.NET Framework 4.6）使用的是V2版本哈希算法，.NET Core/ .NET 5+ 自带的Identity默认使用V3版本哈希算法，导致默认UserManager无法识别旧哈希值，可以通过以下步骤实现兼容：

步骤1：配置Identity密码哈希器兼容模式 #

.NET Core 2.0及以上版本的PasswordHasher已经内置了兼容旧版本的配置项，只需要在Program.cs中注册Identity服务时指定哈希兼容性版本为V2即可：

builder.Services.AddDefaultIdentity<IdentityUser>(options => {
    // 其他Identity配置保持不变
})
.AddEntityFrameworkStores<YourDbContext>()
// 核心配置：指定密码哈希兼容V2版本（对应MVC5 Identity的哈希规则）
.Configure<PasswordHasherOptions>(options => 
    options.CompatibilityMode = PasswordHasherCompatibilityMode.IdentityV2
);

注意：如果不需要复用Identity的其他管理逻辑，也可以单独注入PasswordHasher，不需要完整注册Identity服务。

步骤2：适配旧版Identity数据表结构 #

.NET 6的Identity默认表结构和MVC5的仅有细微差异，如果不想修改原有旧库的表结构，可以通过自定义映射适配：

• 匹配旧表表名：旧表默认命名为AspNetUsers、AspNetRoles等，和新版默认一致无需修改，有自定义命名的话在DbContext的OnModelCreating方法中指定表名映射即可
• 匹配字段属性：旧版Identity的UserId默认是字符串（Guid格式），和新版默认规则一致，如有自定义扩展字段，在自定义IdentityUser子类中添加对应属性即可

步骤3：轻量自定义密码验证逻辑（无需完整引入Identity的场景） #

如果你仅需要实现密码校验功能，不需要使用Identity的UserManager、SignInManager等全套能力，可以直接单独实例化V2版本的PasswordHasher做验证：

// 初始化兼容V2的密码哈希器
var hasher = new PasswordHasher<object>(new OptionsWrapper<PasswordHasherOptions>(
    new PasswordHasherOptions {
        CompatibilityMode = PasswordHasherCompatibilityMode.IdentityV2
    }
));

// 验证逻辑：从旧库中取出对应用户的PasswordHash字段值，和用户输入的明文密码比对
var verificationResult = hasher.VerifyHashedPassword(
    null, 
    storedHashFromOldDb, // 旧库中存储的哈希字符串
    inputPassword // 用户登录输入的明文密码
);

if (verificationResult == PasswordVerificationResult.Success) {
    // 验证通过，执行后续登录逻辑
}

步骤4：平滑升级哈希格式（可选） #

如果后续希望逐步把旧的V2哈希升级为更安全的V3哈希，可以在验证通过时判断返回结果，如果是PasswordVerificationResult.SuccessRehashNeeded，就用新版哈希算法重新计算用户密码的哈希值，更新到数据库中，整个过程用户无感知，不影响原有登录。

注意：如果你的原有MVC5项目自定义了PasswordHasher的哈希逻辑，没有使用Identity默认实现，你需要把旧的哈希算法逻辑迁移到.NET 6项目中，手动实现密码比对即可。

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