Invoke-WebRequest偶发ZIP下载不完整，求解决方案及替代方法

可能的诱因 #

• 服务器临时限流或分块传输中断：部分服务器会对自动化请求做限制，偶尔截断传输导致文件不完整，而浏览器自带完善的会话管理与重试机制，能规避这类问题。
• 默认超时设置过短：Invoke-WebRequest默认超时时间有限，遇到网络波动时直接终止下载，无自动重试逻辑。
• 重定向处理不彻底：部分下载链接存在多级跳转，Invoke-WebRequest可能未正确跟进所有重定向，导致下载到错误内容。

优化Invoke-WebRequest的实用方案 #

1. 延长超时+添加重试+完整性校验 #

通过循环实现重试逻辑，结合文件哈希或大小验证确保下载完整：

$url = "目标文件下载链接"
$outputPath = "本地保存路径\target.zip"
$maxRetry = 3
$isSuccess = $false
# 若服务器提供哈希值，可替换为实际值
$expectedSha256 = "xxxxxxxxx"

for ($i=1; $i -le $maxRetry; $i++) {
    try {
        # 延长超时至5分钟，强制抛出错误以便重试
        Invoke-WebRequest -Uri $url -OutFile $outputPath -TimeoutSec 300 -ErrorAction Stop
        
        # 校验文件哈希
        $actualSha256 = (Get-FileHash -Path $outputPath -Algorithm SHA256).Hash
        if ($actualSha256 -eq $expectedSha256) {
            $isSuccess = $true
            break
        } else {
            Write-Host "第$i次下载哈希不匹配，清理后重试"
            Remove-Item $outputPath -Force
        }
    } catch {
        Write-Host "第$i次下载失败：$($_.Exception.Message)，重试中..."
        if (Test-Path $outputPath) { Remove-Item $outputPath -Force }
    }
}

if (-not $isSuccess) {
    Write-Error "多次重试后仍无法完成有效下载"
}

2. 启用基础解析+强制跟进重定向 #

避免DOM解析带来的额外问题，同时放大重定向次数上限：

Invoke-WebRequest -Uri $url -OutFile $outputPath -UseBasicParsing -MaximumRedirection 10

3. 下载后校验文件大小 #

如果服务器公布了文件字节数，直接对比验证：

$expectedSize = 12345678 # 替换为服务器公布的文件大小
$actualSize = (Get-Item $outputPath).Length
if ($actualSize -ne $expectedSize) {
    Write-Error "文件大小不匹配，下载不完整"
    Remove-Item $outputPath -Force
}

更稳定的替代工具 #

1. Start-BitsTransfer #

Windows原生文件传输工具，自带断点续传、自动重试，稳定性拉满：

Start-BitsTransfer -Source $url -Destination $outputPath -RetryInterval 60 -RetryTimeout 3600

2. 直接调用.NET类 #

WebClient（轻量易用）：

$webClient = New-Object System.Net.WebClient
$webClient.DownloadFile($url, $outputPath)
$webClient.Dispose()

HttpClient（精细控制，支持异步）：

$httpClient = New-Object System.Net.Http.HttpClient
$httpClient.Timeout = [System.TimeSpan]::FromMinutes(5)
$response = $httpClient.GetAsync($url).Result
# 确保请求成功
$response.EnsureSuccessStatusCode()
$fileStream = [System.IO.File]::Create($outputPath)
$response.Content.CopyToAsync($fileStream).Result
$fileStream.Close()
$httpClient.Dispose()

内容的提问来源于stack exchange，提问作者Роман Рослый