Invoke-RestMethod返回字符串而非PSObject/JSON的问题排查与解决

• 重复UTF-8 BOM导致格式识别失效：返回内容开头的是UTF-8编码的字节顺序标记（BOM），这里出现两次说明接口返回的CSV内容带了重复的BOM。Invoke-RestMethod本来会根据响应头的Content-Type自动解析内容，但异常的重复BOM让PowerShell无法正确识别这是CSV格式，所以直接返回原始字符串，没转成预期的PSObject。
• -OutFile的特殊处理逻辑：-OutFile是直接把原始字节流写入文件，系统的CSV阅读器（比如Excel）能自动忽略这种异常BOM，所以生成的文件显示正常。

不用手动分割字符串这么麻烦，直接移除开头的BOM后，用ConvertFrom-Csv一键转成可直接使用的PSObject：

# 移除开头的重复BOM字符
$cleanContent = $result -replace '^\xEF\xBB\xBF\xEF\xBB\xBF'
# 转为PSObject集合
$properResult = $cleanContent | ConvertFrom-Csv

如果不确定BOM重复次数，也可以用通用正则移除所有开头的BOM：

$cleanContent = $result -replace '^(?:\xEF\xBB\xBF)+'
$properResult = $cleanContent | ConvertFrom-Csv

完整优化后的调用代码 #

$Headers = @{
    "Authorization" = "Bearer {0}" -f $token
}

$APIUri = "https://myendpoint/information/blah"

$parameters = @{
    '$expand' = 'someparams'
    '$filter' = "moreparams"
}

$result = Invoke-RestMethod -Headers $headers -Uri $APIUri -Method Get -Body $parameters
# 清理BOM并转成对象
$cleanContent = $result -replace '^(?:\xEF\xBB\xBF)+'
$properResult = $cleanContent | ConvertFrom-Csv

处理完后，$properResult就是标准的PSObject集合，你可以直接访问属性（比如$properResult[0].Column1）或者遍历集合，完全不用手动拆分字符串构建对象。

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