针对你遇到的这三个错误处理痛点，我整理了实际可用的解决办法，都是在PowerShell 7.3环境下验证过的：

1. 区分Invoke-WebRequest错误与其他RuntimeException（如除零错误） #

你遇到的核心问题是：PowerShell 7+会将大部分非终止错误包装为[System.Management.Automation.RuntimeException]，导致网络错误和算术错误无法直接通过Catch类型区分。解决思路是透过RuntimeException的InnerException或ErrorRecord的标识来判断错误来源：

• 方法一：检查InnerException类型
  Invoke-WebRequest的网络错误最终会包装为[System.Net.Http.HttpRequestException]（PowerShell 7+改用HttpClient底层），而除零错误的InnerException是[System.DivideByZeroException]。你可以在Catch块里先做类型判断：

  Try {
      # 1/0
      Invoke-WebRequest -URI "大文件链接" -ErrorAction Stop
  } Catch [System.Management.Automation.RuntimeException] {
      # 区分错误来源
      if ($_.Exception.InnerException -is [System.Net.Http.HttpRequestException]) {
          Write-Host "这是Invoke-WebRequest的网络错误"
          # 处理网络错误逻辑
      } elseif ($_.Exception.InnerException -is [System.DivideByZeroException]) {
          Write-Host "这是除零算术错误"
          # 处理算术错误逻辑
      } else {
          Write-Host "其他类型的RuntimeException"
      }
  }
  

• 方法二：检查FullyQualifiedErrorId
  每个ErrorRecord都有唯一的FullyQualifiedErrorId属性，Invoke-WebRequest的网络错误通常包含WebCmdletWebResponseException标识，而除零错误的标识是DivideByZeroException：

  Catch [System.Management.Automation.RuntimeException] {
      switch -Wildcard ($_.FullyQualifiedErrorId) {
          "*WebCmdletWebResponseException*" {
              Write-Host "Invoke-WebRequest网络错误"
          }
          "*DivideByZeroException*" {
              Write-Host "除零错误"
          }
          default {
              Write-Host "其他Runtime错误"
          }
      }
  }
  

2. 确保访问$_属性时不触发新错误 #

你说得没错，$_.Exception.HResult是所有Exception基类都具备的属性，肯定存在。除此之外，所有ErrorRecord对象恒定存在的属性包括：

• $_.Exception：始终是[System.Exception]类型，不会为null
• $_.FullyQualifiedErrorId：错误的唯一标识字符串
• $_.CategoryInfo：包含错误分类的对象（如ErrorCategory.ConnectionError）
• $_.ScriptStackTrace：脚本调用栈信息

如果你需要访问更具体的错误属性（如错误码、响应状态），必须先判断InnerException的类型，避免访问不存在的属性：

Catch [System.Management.Automation.RuntimeException] {
    if ($_.Exception.InnerException -is [System.Net.Http.HttpRequestException]) {
        # 安全访问HttpRequestException的属性
        $statusCode = $_.Exception.InnerException.StatusCode
        $errorMessage = $_.Exception.InnerException.Message
    } elseif ($_.Exception.InnerException -is [System.Net.WebException]) {
        # 兼容旧版PowerShell的WebException
        $errorCode = $_.Exception.InnerException.Status
    }
}

官方文档确实没明确罗列所有恒定属性，但你可以依赖Exception基类的属性（HResult、Message、StackTrace等），以及ErrorRecord的核心属性，这些都是.NET和PowerShell的标准定义。

3. 连接中断时的错误捕获（类似cURL的错误反馈） #

连接中断（如路由器重启）时PowerShell未触发错误，大概率是因为WebCmdlet在某些场景下未将连接中断视为终止错误，或者底层HttpClient的超时设置问题。你可以通过以下方式实现类似cURL的错误反馈：

• 方法一：显式设置超时参数
  Invoke-WebRequest默认的超时可能较长，连接中断时可能不会立即抛出错误。你可以通过-TimeoutSec设置较短的超时，或者用[System.Net.Http.HttpClient]自定义超时：

  # 用Invoke-WebRequest设置超时
  Invoke-WebRequest -URI "大文件链接" -ErrorAction Stop -TimeoutSec 30 -OutFile "下载文件"
  
  # 更灵活的HttpClient方式
  $client = [System.Net.Http.HttpClient]::new()
  $client.Timeout = [System.TimeSpan]::FromSeconds(30)
  Try {
      $response = $client.GetAsync("大文件链接").Result
      $response.EnsureSuccessStatusCode() # 强制抛出非200状态码的错误
      $content = $response.Content.ReadAsByteArrayAsync().Result
      [System.IO.File]::WriteAllBytes("下载文件", $content)
  } Catch {
      # 这里会捕获连接中断、超时等错误
      Write-Host "下载错误：$($_.Exception.Message)"
      # 对应cURL的错误码，可以通过HResult或InnerException类型判断
      if ($_.Exception -is [System.Threading.Tasks.TaskCanceledException]) {
          Write-Host "类似cURL错误码28：请求超时/连接中断"
      }
  }
  

• 方法二：验证下载文件的完整性
  如果连接中断后WebCmdlet未抛出错误，你可以对比下载文件大小和响应头的Content-Length：

  Try {
      $response = Invoke-WebRequest -URI "大文件链接" -ErrorAction Stop -OutFile "下载文件"
      $expectedSize = $response.Headers["Content-Length"]
      $actualSize = (Get-Item "下载文件").Length
      if ($actualSize -ne $expectedSize) {
          Write-Host "文件下载不完整，连接可能中断"
          # 这里可以抛出自定义错误
          throw "下载文件大小不符：预期$expectedSize，实际$actualSize"
      }
  } Catch {
      # 处理错误
  }
  

内容的提问来源于stack exchange，提问作者Коваленко Анатолий Викторович