PowerShell中Invoke-WebRequest的页面超时拦截与处理方法

问题场景 #

尝试下载文件时遇到目标站点无法访问，原始执行代码如下：

$url = "https://notepad-plus-plus.org/downloads"
$page = Invoke-WebRequest -uri $url -UseBasicParsing

需要解决以下两个问题：

• 能否设置2秒超时，在无响应时优雅终止请求（可能因站点故障或自身网络问题导致）？
• 如何检测返回内容是连接超时/无效数据还是可处理的有效数据？

用户自行尝试的代码：

$url = "https://notepad-plus-plus.org/downloads"   # 最终目标URL示例：https://github.com/notepad-plus-plus/notepad-plus-plus/releases/download/v8.4.6/npp.8.4.6.portable.x64.zip
try {
    $page = Invoke-WebRequest -uri $url -UseBasicParsing -TimeoutSec 3
}
catch { 
    if ($_.Exception.Response.StatusCode -band 522) { "bad!"}
}

解决方案 #

1. 设置超时并优雅终止请求 #

直接使用Invoke-WebRequest的-TimeoutSec参数即可指定超时时间，比如设置2秒超时：

$url = "https://notepad-plus-plus.org/downloads"
try {
    $page = Invoke-WebRequest -Uri $url -UseBasicParsing -TimeoutSec 2
    # 请求成功后的处理逻辑
    Write-Host "请求成功，返回状态码：$($page.StatusCode)"
}
catch {
    # 捕获超时或其他异常
    Write-Host "请求终止：$($_.Exception.Message)"
}

当请求超过指定时间无响应时，会自动抛出异常进入catch块，实现优雅终止。

2. 区分异常类型与数据有效性 #

不同的异常场景需要不同的判断逻辑：

• 连接超时/网络故障：这类异常通常没有Response对象，直接通过$_.Exception.GetType().Name判断，比如WebException或HttpRequestException。
• HTTP错误状态码（如404、522等）：这类异常会包含Response对象，可以读取StatusCode来判断。
• 有效数据判断：请求成功后，可通过$page.StatusCode是否为200系列（200、201等），以及$page.Content是否为空或符合预期格式来验证。

改进后的完整处理代码：

$url = "https://notepad-plus-plus.org/downloads"
try {
    $page = Invoke-WebRequest -Uri $url -UseBasicParsing -TimeoutSec 2
    
    # 验证返回数据有效性
    if ($page.StatusCode -ge 200 -and $page.StatusCode -lt 300) {
        if (-not [string]::IsNullOrEmpty($page.Content)) {
            Write-Host "返回有效数据，状态码：$($page.StatusCode)"
            # 后续处理逻辑，比如解析页面找下载链接
        }
        else {
            Write-Host "请求成功但返回内容为空"
        }
    }
    else {
        Write-Host "请求返回非成功状态码：$($page.StatusCode)"
    }
}
catch {
    if ($_.Exception.Response) {
        # 处理HTTP状态码异常
        $statusCode = [int]$_.Exception.Response.StatusCode
        Write-Host "HTTP错误，状态码：$statusCode"
        switch ($statusCode) {
            522 { Write-Host "站点连接超时（Cloudflare 522错误）" }
            404 { Write-Host "目标页面不存在" }
            default { Write-Host "其他HTTP错误：$statusCode" }
        }
    }
    else {
        # 处理无响应/网络故障类异常
        Write-Host "网络异常或请求超时：$($_.Exception.Message)"
    }
}

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