PowerShell调用REST接口错误捕获失效，请求排查代码问题

问题根源 #

在PowerShell 5.1中，Invoke-RestMethod和Invoke-WebRequest默认不会将HTTP状态码≥400的响应（比如404、500）视为终止错误，只会将其作为非终止错误输出到错误流。这直接导致：

• try/catch块无法触发，因为只有终止错误才会进入catch逻辑
• $?会返回True，因为cmdlet本身执行完成，没有崩溃
• Errorlevel/$LASTEXITCODE完全无效，这两个变量仅用于外部命令的退出码，和PowerShell cmdlet无关

另外，如果你使用的是Invoke-RestMethod，遇到404这类错误时，它默认会将错误信息输出到错误流，但如果脚本没有捕获错误流（比如用2>&1），就会看不到任何输出，误以为执行无结果。

解决方法 #

方法1：用-ErrorAction Stop强制转为终止错误（推荐） #

通过添加-ErrorAction Stop参数，把HTTP错误转为终止错误，这样try/catch就能正常捕获并处理：

try {
    # 添加-ErrorAction Stop参数
    $response = Invoke-RestMethod -Uri "https://urliswrong.com/api/1/rest/slsched/feed/SNOWFLAKE/snow_main?TABLE_NAME=temp1234" -ErrorAction Stop
    # 请求成功后的逻辑
} catch {
    # 从异常中提取HTTP状态码和描述
    $statusCode = $_.Exception.Response.StatusCode.value__
    $statusMsg = $_.Exception.Response.StatusDescription
    Write-Host "REST请求失败: 状态码 $statusCode - $statusMsg"
    # 这里添加你的告警逻辑，比如发送邮件、调用告警接口等
}

方法2：检查响应对象的状态码（适用于Invoke-WebRequest） #

Invoke-WebRequest会返回包含状态码的响应对象，即使遇到HTTP错误也不会默认终止，你可以直接检查状态码：

# 用-SilentlyContinue抑制默认错误输出
$response = Invoke-WebRequest -Uri "https://urliswrong.com/api/1/rest/slsched/feed/SNOWFLAKE/snow_main?TABLE_NAME=temp1234" -ErrorAction SilentlyContinue

if (-not $response) {
    Write-Host "请求无响应：可能是域名解析失败或网络中断"
} elseif ($response.StatusCode -ge 400) {
    Write-Host "请求失败，状态码: $($response.StatusCode)"
    # 告警逻辑
} else {
    # 请求成功后的处理
    $response.Content
}

额外说明 #

如果是域名不存在/网络不通这类无法建立连接的错误，即使不加-ErrorAction Stop，try/catch也能捕获，因为这类错误属于终止错误。只有服务器返回的HTTP错误（如404、403）需要手动转为终止错误才能被try/catch捕获。

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