网页文件MD5哈希与本地下载文件MD5匹配失败问题排查

核心问题是网页返回的Content-MD5是二进制MD5值的Base64编码，而本地计算的是二进制MD5值的十六进制字符串，两者只是格式不同，只要正确转换即可比对。以下是两种可行的解决方案：

方案1：将本地十六进制MD5转为Base64比对 #

直接把本地计算的十六进制MD5转换成和网页一致的Base64格式，再做匹配校验：

# 本地文件计算出的十六进制MD5
$localHexMD5 = "B68B6661AB69D7827036104B670629A2"
# 十六进制转字节数组
$md5Bytes = [byte[]] -split ($localHexMD5 -replace '(.{2})', '$1 ')
# 字节数组转Base64字符串
$localBase64MD5 = [Convert]::ToBase64String($md5Bytes)
# 网页返回的Content-MD5
$remoteBase64MD5 = "totmYatp14JwNhBLZwYpog=="

# 执行比对
if ($localBase64MD5 -eq $remoteBase64MD5) {
    Write-Host "哈希匹配成功"
} else {
    Write-Host "哈希匹配失败"
    Write-Host "本地转换后Base64: $localBase64MD5"
    Write-Host "网页返回Base64: $remoteBase64MD5"
}

方案2：将网页Base64 MD5转为十六进制比对 #

把网页返回的Base64格式MD5转换成十六进制，和本地计算值直接比对：

# 网页返回的Content-MD5（Base64格式）
$remoteBase64MD5 = "totmYatp14JwNhBLZwYpog=="
# Base64转字节数组
$md5Bytes = [Convert]::FromBase64String($remoteBase64MD5)
# 字节数组转十六进制字符串（自动大写，去掉分隔符）
$remoteHexMD5 = [BitConverter]::ToString($md5Bytes) -replace '-', ''
# 本地计算的十六进制MD5
$localHexMD5 = "B68B6661AB69D7827036104B670629A2"

# 执行比对（用-ieq可忽略大小写差异）
if ($remoteHexMD5 -ieq $localHexMD5) {
    Write-Host "哈希匹配成功"
} else {
    Write-Host "哈希匹配失败"
    Write-Host "网页转换后十六进制: $remoteHexMD5"
    Write-Host "本地计算十六进制: $localHexMD5"
}

额外排查点 #

如果转换后仍不匹配，且Content-Length一致，需要确认：

• 本地文件是否下载完整：虽然长度一致，但可能存在传输过程中的字节篡改
• 服务器是否返回压缩内容的MD5：若服务器开启了Gzip/Brotli压缩，Content-MD5可能对应压缩后的文件，而你下载的是解压后的版本，此时需要下载原始压缩文件再计算哈希

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