PowerShell：封装带重试逻辑的异常处理为通用函数的问询

1. 方案可行性与潜在陷阱 #

这个方向完全可行，临时异常重试是处理资源竞争、网络波动这类场景的标准方案。但要注意几个潜在陷阱：

• 非临时异常被无效重试：如果把永久异常（比如权限不足、文件不存在的永久状态）误判为临时异常，会导致无意义的重试浪费时间，必须严格匹配目标异常类型。
• 脚本块的副作用风险：如果代码块执行到一半抛出异常，重试会重复执行已完成的操作。比如复制文件到一半失败，重试可能导致文件重复写入损坏，这类场景要确保代码块是幂等的（重复执行结果一致）。
• 固定等待时长的局限性：不同场景的恢复时间不同，比如网络波动可能只需1秒，文件锁释放可能需要10秒，最好让等待时长和重试次数可配置，不要写死。
• 异常捕获不全：部分PowerShell命令默认不抛出终止异常，即使加了-ErrorAction:Stop也可能有遗漏，需要在函数内统一设置错误行为确保捕获到终止异常。

2. 自动添加-errorAction:Stop的实现 #

可以在函数内临时修改$ErrorActionPreference为Stop，执行完脚本块后再恢复原始设置，无需调用者手动添加参数。核心逻辑是在try块内修改全局错误行为，finally块还原，避免影响外部环境。

3. 传递代码块的编程概念 #

在PowerShell中，这种传递可执行代码片段的参数叫做脚本块（Script Block），而接受脚本块作为参数的函数属于高阶函数范畴——即可以接收或返回函数/代码块的函数。

脚本块参数传递与返回值优化建议 #

• 参数类型约束：给脚本块参数加上[scriptblock]类型约束，确保调用者传入正确类型的参数，避免类型错误。
• 支持参数传递：允许调用者给脚本块传递参数，通过@ArgumentList展开参数列表，提升函数通用性。
• 结构化返回值：返回包含执行状态、结果、重试次数、异常列表的自定义对象，方便调用者后续处理。
• 可配置重试策略：把重试次数、等待时长设为可选参数，默认值用你常用的10次/6秒，同时允许调用者按需修改。

完整实现示例 #

function Retry-Command {
    [CmdletBinding()]
    param (
        [Parameter(Mandatory=$true)]
        [scriptblock]$ScriptBlock,
        [Parameter(Mandatory=$true)]
        [Type]$TargetException,
        [int]$MaxRetries = 10,
        [int]$RetryDelaySeconds = 6,
        [object[]]$ArgumentList
    )

    $retryCount = 0
    $errors = @()
    $result = $null
    $success = $false

    do {
        try {
            # 临时设置错误行为为终止，确保所有异常被捕获
            $originalErrorAction = $ErrorActionPreference
            $ErrorActionPreference = 'Stop'
            
            # 执行脚本块并传递参数
            $result = & $ScriptBlock @ArgumentList
            
            $success = $true
            break
        }
        catch {
            if ($_.Exception -is $TargetException) {
                $retryCount++
                $errors += $_
                Write-Verbose "Retry $retryCount/$MaxRetries: $($_.Exception.Message)"
                
                if ($retryCount -lt $MaxRetries) {
                    Start-Sleep -Seconds $RetryDelaySeconds
                }
            }
            else {
                # 非目标异常直接抛出，不重试
                throw $_
            }
        }
        finally {
            # 恢复原始错误行为设置
            $ErrorActionPreference = $originalErrorAction
        }
    } while ($retryCount -lt $MaxRetries)

    # 返回结构化结果
    [PSCustomObject]@{
        Success = $success
        Result = $result
        RetryCount = $retryCount
        Errors = $errors
    }
}

调用示例 #

# 尝试删除被锁定的ZIP文件，最多重试5次，每次等待3秒
$deleteResult = Retry-Command -ScriptBlock { Remove-Item -Path 'C:\temp\extracted.zip' } `
    -TargetException [System.IO.IOException] `
    -MaxRetries 5 `
    -RetryDelaySeconds 3 `
    -Verbose

if ($deleteResult.Success) {
    Write-Host "操作成功，重试次数: $($deleteResult.RetryCount)"
}
else {
    Write-Error "操作失败，重试次数: $($deleteResult.RetryCount)，错误信息: $($deleteResult.Errors.Message -join '; ')"
}

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