C#哈希算法密码校验失效问题求助，升级Windows 11后功能异常

问题根因排查&解决方法 #

你提供的密码哈希校验逻辑本身没有语法或算法错误，升级Win11后出现校验失败，基本都是以下几个常见变动导致的：

• 系统区域编码变更：Win11默认新增了Beta版UTF-8全局编码支持，很多用户升级时会自动开启该选项。如果你之前存储passwordHash、passwordSalt时用了Encoding.Default等依赖系统默认编码的方式转字符串存储，编码变更后读取时转出来的字节数组会和原始值完全不一致，导致校验失败。
• 字节数组存储/读取逻辑异常：很多开发者会把哈希、盐值转成十六进制字符串或Base64存入数据库，如果转换逻辑依赖系统环境配置，升级后也可能出现转换偏差。
• 输入参数隐式修改：升级Win11后如果对应的.NET运行时、Web服务器组件也同步更新，可能存在API模型绑定自动Trim字符串、输入法默认补全空格等情况，导致接口拿到的明文密码和用户原始输入不一致。

分步排查步骤 #

1. 先验证哈希工具类本身的可用性：本地执行以下测试代码，看是否返回true，如果返回true说明工具类逻辑正常，问题出在存储、读取、参数传递环节

var testPwd = "TestPass123!";
HashingHelper.CreatePasswordHash(testPwd, out var hash, out var salt);
var verifyResult = HashingHelper.VerifyPasswordHash(testPwd, hash, salt);
// 输出verifyResult看是否为true

2. 加日志确认三个核心值是否匹配：
   • 注册时打印Convert.ToBase64String(passwordSalt)、Convert.ToBase64String(passwordHash)的值，和数据库中实际存储的值对比
   • 登录时打印接口接收到的明文密码（前后加特殊符号包裹，确认是否有多余空格/不可见字符）、从数据库读取后转Base64的盐值、哈希值，和注册时的存储值对比
3. 检查系统区域设置：打开「设置→时间和语言→语言和区域→管理语言设置→更改系统区域设置」，确认是否勾选了「Beta版：使用Unicode UTF-8提供全球语言支持」，如果已勾选，取消勾选重启设备后再测试。

兼容优化建议 #

后续存储哈希、盐值时统一使用Base64做固定转换，不要依赖系统默认编码，示例如下：

// 存储前转Base64字符串
string saltToStore = Convert.ToBase64String(passwordSalt);
string hashToStore = Convert.ToBase64String(passwordHash);

// 读取时转回字节数组
byte[] saltFromDb = Convert.FromBase64String(saltStoredInDb);
byte[] hashFromDb = Convert.FromBase64String(hashStoredInDb);

另外可以把逐字节对比的逻辑替换为.NET内置的防时序攻击方法，提升安全性：

// 替换原有的for循环对比
return System.Security.Cryptography.CryptographicOperations.FixedTimeEquals(computedHash, passwordHash);

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