C#中使用Argon2哈希密码后登录验证结果不一致问题排查

1. Argon2参数未完全匹配 #

注册时你明确设置了以下Argon2配置：

argon2.DegreeOfParallelism = 4;
argon2.Iterations = 4;
argon2.MemorySize = 256 * 256;

如果登录计算哈希时，任意一个参数（比如迭代次数、并行度、内存占用）和注册时不一致，生成的哈希值必然不同。必须保证登录逻辑的Argon2配置与注册完全一致。

2. 盐值的Base64正反转换错误 #

注册时你用Convert.ToBase64String(salt)将盐值转为字符串存储，但登录时从数据库取出盐值后，必须用Convert.FromBase64String(数据库盐值字符串)转回byte[]，再传入哈希方法。如果登录时跳过了反向转换，或者用了错误的编码（比如直接用Encoding.UTF8.GetBytes解析盐值字符串），会导致盐值完全不匹配，哈希结果自然无法对齐。

3. 数据库字段长度不足导致数据截断 #

检查SQL Server中存储哈希的password字段、存储盐值的token字段的类型长度：

• 16字节哈希转Base64后约24个字符
• 16字节盐值转Base64后也约24个字符

如果字段是VARCHAR(20)这类长度不足的类型，存储时会自动截断字符串。登录时取出的是截断后的不完整值，必然无法匹配。建议将这两个字段设置为VARCHAR(64)或NVARCHAR(64)，确保容纳完整的Base64字符串。

4. 密码编码方式不一致 #

注册时用Encoding.UTF8.GetBytes(password)将密码转成字节数组，登录时必须用完全相同的编码处理登录密码。如果登录时误用了Encoding.Default或其他编码，会导致密码的字节数组差异，最终哈希结果不同。

5. Argon2实例配置顺序问题 #

部分Argon2库对配置顺序有要求，你当前先设置盐值再设置参数的写法，可能导致部分参数未生效。可以调整配置顺序，先设置参数再绑定盐值：

private byte[] HashPassword(string password, byte[] salt)
{
    var argon2 = new Argon2id(Encoding.UTF8.GetBytes(password));
    // 先设置参数，再设置盐值
    argon2.DegreeOfParallelism = 4;
    argon2.Iterations = 4;
    argon2.MemorySize = 256 * 256;
    argon2.Salt = salt;

    return argon2.GetBytes(16);
}

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