PowerShell环境变量与等效字符串不匹配致Invoke-RestMethod调用失败

问题根源 #

你的环境变量$env:token包含不可见的控制字符（比如换行符、回车符、制表符或首尾空格），这些字符在echo输出时不会显示，但会导致字符串实际内容与硬编码值不一致，同时破坏HTTP请求头的格式，触发ArgumentException。

解决步骤 #

1. 检查环境变量的隐藏字符 #

先通过十六进制查看确认控制字符的存在：

$env:token | Format-Hex

如果输出中出现0D（回车符）、0A（换行符）或其他小于20的ASCII码值，就是问题所在。

2. 清理令牌中的控制字符 #

使用以下方法去除环境变量中的无效字符：

• 基础清理：去除首尾所有空白字符（包括空格、换行、回车、制表符）

$cleanToken = $env:token.Trim()

• 彻底清理：去除所有ASCII控制字符（适用于更复杂的情况）

# 0..31 对应所有ASCII控制字符的编码范围
$cleanToken = $env:token.Trim([char[]]0..31)

3. 使用清理后的令牌发起请求 #

修改代码使用清理后的变量：

$props = @{
    Uri = $my_url
    Method = "POST"
    ContentType = "application/json"
    Headers = @{ Authorization = "Bearer $cleanToken" }
}

$payload = Invoke-RestMethod @props

4. 验证清理结果 #

确认清理后的字符串与硬编码值一致：

$bearer1 = $cleanToken
$bearer2 = "Token123456789"
echo ($bearer1 -eq $bearer2) # 此时应返回True

补充说明 #

环境变量出现控制字符通常是设置时的操作失误导致：比如从多行文本复制令牌时带入了换行符，或是通过脚本写入环境变量时未处理换行/空格。清理后即可避免HTTP请求头的格式错误。

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