.NET Core 8 Web API兼容旧.NET 4.6 MVC Identity密码验证失败

问题分析 #

核心矛盾是ASP.NET Core 8的Identity密码验证逻辑与旧.NET 4.6 MVC项目的默认密码哈希不兼容，即使开启IdentityV2兼容模式仍验证失败，大概率是迭代次数不匹配导致：旧.NET Framework Identity默认使用1000次PBKDF2迭代，而ASP.NET Core的PasswordHasherV2默认是10000次，迭代次数不一致会直接导致验证失败。

解决方案 #

1. 调整PasswordHasher配置，匹配旧项目迭代次数 #

在AddIdentity注册后添加配置，同时指定兼容模式和旧项目的迭代次数：

builder.Services.AddIdentity<User, IdentityRole>()
                .AddEntityFrameworkStores<MydbContext>();

// 配置密码哈希兼容旧.NET Framework Identity
builder.Services.Configure<PasswordHasherOptions>(options =>
{
    options.CompatibilityMode = PasswordHasherCompatibilityMode.IdentityV2;
    options.IterationCount = 1000; // 旧.NET Framework Identity默认迭代次数
});

2. 手动验证密码哈希，排除其他干扰 #

绕过SignInManager直接用PasswordHasher验证，确认配置是否生效：

[HttpGet("Authenticate")]
public async Task<ActionResult> Authenticate(string username, string password)
{
    var user = await _userManager.FindByNameAsync(username);
    if (user == null) return NotFound("用户不存在");

    // 手动创建PasswordHasher并验证
    var hasher = new PasswordHasher<User>(new PasswordHasherOptions
    {
        CompatibilityMode = PasswordHasherCompatibilityMode.IdentityV2,
        IterationCount = 1000
    });

    var verifyResult = hasher.VerifyHashedPassword(user, user.PasswordHash, password);
    if (verifyResult == PasswordVerificationResult.Success)
    {
        await _signInManager.SignInAsync(user, isPersistent: false);
        return Ok("登录成功");
    }

    return BadRequest("密码错误");
}

3. 确认User类与数据库字段映射正确 #

确保User类正确继承IdentityUser，且数据库中的PasswordHash字段为nvarchar(max)类型，无自定义映射导致的字段读取错误。

4. 修复异步代码死锁风险 #

原代码直接调用check.Result会引发异步死锁，改为await方式：

var checkResult = await _signInManager.CheckPasswordSignInAsync(user, password, false);
if (checkResult.Succeeded)
{
    return Ok();
}

额外排查点 #

若上述配置仍无效，可将旧数据库中的PasswordHash值进行Base64解码，查看前4字节对应的整数（即迭代次数），若旧项目修改过默认迭代次数，需将IterationCount改为对应数值。

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