Blazor Server中使用SHA3.NET生成SHA-3哈希出现乱码问题求助

核心问题 #

你遇到的乱码是因为直接将哈希字节数组通过UTF-8编码转换为字符串导致的。SHA-3生成的哈希是原始二进制数据，包含大量无法被UTF-8编码正确解析的字节序列，强行转换必然出现乱码。你预期的9uBnQbETH5V7FMDtk-6x格式属于Base64（或URL安全Base64）编码，这是哈希值的标准字符串表示方式。

修复步骤 #

1. 修正哈希字符串的转换方式 #

将哈希字节数组转换为Base64或十六进制字符串，而非直接用UTF-8解析。以下是两种常见实现：

方式一：Base64编码（接近你预期的格式）

修改GetHash方法：

public string GetHash(string value)
{
    byte[] val = Encoding.UTF8.GetBytes(value);
    byte[] hash = sh.ComputeHash(val);
    // 转换为标准Base64字符串，若需要URL安全格式可替换为ToBase64UrlString
    return Convert.ToBase64String(hash);
}

如果需要URL安全的Base64（去掉+、/，替换为-、_，去掉末尾=），可以用：

return Convert.ToBase64String(hash).Replace('+', '-').Replace('/', '_').TrimEnd('=');

方式二：十六进制编码

如果需要全字母数字的哈希字符串，可转换为十六进制：

public string GetHash(string value)
{
    byte[] val = Encoding.UTF8.GetBytes(value);
    byte[] hash = sh.ComputeHash(val);
    return BitConverter.ToString(hash).Replace("-", "").ToLowerInvariant();
}

2. 完善加盐逻辑（你提到的加盐处理未在代码中体现） #

加盐的正确做法是将密码与随机生成的盐值拼接后再计算哈希，并且需要保存盐值（用于后续验证密码）。示例如下：

// 生成随机盐值（推荐16字节以上）
public byte[] GenerateSalt()
{
    byte[] salt = new byte[16];
    using (var rng = System.Security.Cryptography.RandomNumberGenerator.Create())
    {
        rng.GetBytes(salt);
    }
    return salt;
}

// 带加盐的哈希计算
public string GetHashedPassword(string password, byte[] salt)
{
    // 将盐值与密码字节拼接
    byte[] passwordBytes = Encoding.UTF8.GetBytes(password);
    byte[] combinedBytes = new byte[passwordBytes.Length + salt.Length];
    Buffer.BlockCopy(passwordBytes, 0, combinedBytes, 0, passwordBytes.Length);
    Buffer.BlockCopy(salt, 0, combinedBytes, passwordBytes.Length, salt.Length);
    
    byte[] hash = sh.ComputeHash(combinedBytes);
    // 可以将盐值与哈希一起存储（比如拼接后转Base64）
    byte[] saltedHash = new byte[salt.Length + hash.Length];
    Buffer.BlockCopy(salt, 0, saltedHash, 0, salt.Length);
    Buffer.BlockCopy(hash, 0, saltedHash, salt.Length, hash.Length);
    
    return Convert.ToBase64String(saltedHash);
}

3. 修正IDisposable实现（当前实现不规范） #

你的Dispose方法只是将sh设为null，没有释放底层资源。正确实现应该调用Sha3的Dispose方法（如果该类实现了IDisposable）：

public void Dispose()
{
    sh?.Dispose();
    GC.SuppressFinalize(this);
}

排查方向总结 #

• 永远不要将原始哈希二进制数据直接通过字符编码转换为字符串，必须用Base64/十六进制等二进制转字符串的标准方式。
• 加盐逻辑必须包含随机盐值的生成与存储，不能省略盐值直接哈希密码。
• 检查第三方库的Sha3实例是否支持重复调用ComputeHash（部分哈希算法实例单次使用后需重新创建，不过SHA3.NET的Sha3应该支持多次调用，但如果遇到问题可以尝试每次计算哈希时重新创建实例）。

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