PowerShell如何对二进制哈希字符串做URL安全Base64编码用于HTTP请求

核心转换函数 #

直接复制以下代码即可使用：

function ConvertTo-UrlSafeBase64 {
    param(
        [Parameter(Mandatory=$true)]
        [byte[]]$BinaryHashBytes
    )
    # 生成标准Base64编码
    $standardBase64 = [Convert]::ToBase64String($BinaryHashBytes)
    # 替换特殊字符、移除末尾填充符，完成URL安全转换
    $urlSafeBase64 = $standardBase64.Replace('+', '-').Replace('/', '_').TrimEnd('=')
    return $urlSafeBase64
}

常见场景调用示例 #

场景1：输入为哈希计算得到的原始字节数组 #

# 示例：计算字符串的MD5哈希后转URL安全Base64
$inputStr = "your_test_content"
$md5 = [System.Security.Cryptography.MD5]::Create()
$hashBytes = $md5.ComputeHash([System.Text.Encoding]::UTF8.GetBytes($inputStr))
$finalHash = ConvertTo-UrlSafeBase64 -BinaryHashBytes $hashBytes
# 输出可直接用于身份验证的结果
Write-Host $finalHash

场景2：输入为0/1组成的二进制文本字符串 #

如果你的binary_hash_str是由0和1组成的纯文本二进制串，先执行以下代码转成字节数组后再调用转换函数：

# 输入的二进制文本字符串示例
$binaryHashStr = "101011010111001010001101..."
# 按每8位拆分转字节数组
$byteList = [System.Collections.Generic.List[byte]]::new()
for ($i = 0; $i -lt $binaryHashStr.Length; $i += 8) {
    $byteStr = $binaryHashStr.Substring($i, [Math]::Min(8, $binaryHashStr.Length - $i))
    # 不足8位末尾补0
    $byteStr = $byteStr.PadRight(8, '0')
    $byteList.Add([Convert]::ToByte($byteStr, 2))
}
$hashBytes = $byteList.ToArray()
# 调用转换函数
$finalHash = ConvertTo-UrlSafeBase64 -BinaryHashBytes $hashBytes

实现说明 #

• 无外部依赖，基于.NET内置方法实现，兼容所有主流PowerShell版本
• 严格遵循RFC 4648 URL安全Base64编码标准，输出结果可直接放入HTTP请求参数、Header中使用，无需额外转义
• 若后续需要解码，反向操作即可：先补全末尾的=填充符，再将-换回+、_换回/，最后调用[Convert]::FromBase64String()即可还原原始字节

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