PowerShell中Write-Error触发错误捕获块执行异常问题

这个问题其实是PowerShell处理终止错误时的一个常见细节——当你设置$ErrorActionPreference = 'Stop'时，Write-Error产生的错误并不会直接抛出WriteErrorException，而是会被PowerShell包装成一个RuntimeException实例，这就是为什么你的第二个catch块会优先匹配到异常。

背后的机制 #

Write-Error默认生成的是非终止错误，但当ErrorActionPreference设为Stop时，PowerShell会将所有非终止错误提升为终止错误。在这个转换过程中，PowerShell不会直接抛出原始的WriteErrorException，而是会创建一个新的RuntimeException，并把原始的WriteErrorException作为InnerException嵌入进去。

这就导致当你在try块中调用Write-Error时，抛出的顶层异常是RuntimeException，自然会被你的第二个catch块（专门捕获RuntimeException）先捕获，而不是第一个针对WriteErrorException的块——因为第一个块匹配的是内层异常，不是顶层的包装异常。

解决方法 #

针对这个问题，有几种可行的处理方式：

1. 检查RuntimeException的内部异常

如果你想保留现有的catch块结构，可以在RuntimeException的catch块中判断内部异常类型：

$script:ErrorActionPreference = 'Stop'

try {
    Write-Error "Test error from Write-Error"
}
catch [Microsoft.PowerShell.Commands.WriteErrorException] {
    Write-Host "直接捕获到WriteErrorException（仅当直接抛出该异常时触发）"
}
catch [System.Management.Automation.RuntimeException] {
    if ($_.Exception.InnerException -is [Microsoft.PowerShell.Commands.WriteErrorException]) {
        Write-Host "捕获到被RuntimeException包装的WriteErrorException"
    } else {
        Write-Host "捕获到其他类型的RuntimeException"
    }
}
catch {
    Write-Host "捕获到其他所有异常"
}

2. 直接抛出WriteErrorException

如果你希望第一个catch块直接触发，可以跳过Write-Error，直接实例化并抛出WriteErrorException：

$script:ErrorActionPreference = 'Stop'

try {
    throw [Microsoft.PowerShell.Commands.WriteErrorException]::new("直接抛出的WriteErrorException")
}
catch [Microsoft.PowerShell.Commands.WriteErrorException] {
    Write-Host "成功捕获到WriteErrorException"
}
catch [System.Management.Automation.RuntimeException] {
    Write-Host "捕获到RuntimeException"
}
catch {
    Write-Host "捕获到其他异常"
}

3. 调整错误处理策略

如果不需要将所有非终止错误转为终止错误，可以针对Write-Error单独设置-ErrorAction Stop，而不是全局设置$ErrorActionPreference，不过这并不会改变异常被包装的行为——只是缩小了生效范围。

补充说明 #

这个行为在PowerShell 5.1和PowerShell Core 6.0中是一致的，因为这是PowerShell将非终止错误转换为终止错误的标准逻辑。记住：只要是通过非终止错误提升而来的终止错误，PowerShell都会用RuntimeException来包装原始异常。

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