命令行与文本处理 / 系统课时

处理错误与异常

处理错误与异常

本课解决 PowerShell 脚本在命令失败、业务校验不通过或资源需要清理时如何保持可控执行的问题。完成后,你能把非终止错误转换为可捕获异常,并从错误记录中提取可用于日志和排障的关键信息。

学习目标

  • 区分终止错误与非终止错误,理解 ErrorAction 的作用范围
  • 使用 try、catch、finally 和 throw 组织失败流程
  • 从错误记录中提取异常类型、错误类别和调用位置

区分非终止错误与终止错误

PowerShell 的很多 cmdlet 遇到单个对象失败时,默认会报告错误后继续处理,这类错误称为非终止错误。它不会自动进入 catch,因此只写 try 和 catch 仍可能捕获不到失败。

对当前命令使用 -ErrorAction Stop,可以把非终止错误提升为终止错误,使控制流立即跳入 catch。ErrorAction 是 cmdlet 的公共参数,不会自动把原生可执行程序的非零退出码变成异常;调用外部程序后还要检查 $LASTEXITCODE。

建立完整的异常处理流程

下面的脚本演示两种失败:读取不存在的配置文件,以及主动使用 throw 拒绝非法金额。两个分支最终都会执行 finally。

powershell
function Invoke-OrderCheck {
    param(
        [decimal]$Amount,
        [string]$ConfigPath
    )

    try {
        Write-Output "开始检查金额:$Amount"

        # 将 Get-Item 的非终止错误提升为可捕获异常
        Get-Item -LiteralPath $ConfigPath -ErrorAction Stop | Out-Null

        if ($Amount -le 0) {
            throw [System.ArgumentOutOfRangeException]::new(
                "Amount",
                "金额必须大于 0"
            )
        }

        Write-Output "检查通过"
    }
    catch [System.Management.Automation.ItemNotFoundException] {
        Write-Output "配置文件不存在"
        Write-Output "错误类别:$($_.CategoryInfo.Category)"
    }
    catch [System.ArgumentOutOfRangeException] {
        Write-Output "业务校验失败"
        Write-Output "异常类型:$($_.Exception.GetType().Name)"
        Write-Output "参数名:$($_.Exception.ParamName)"
    }
    catch {
        Write-Output "未分类错误:$($_.Exception.Message)"
    }
    finally {
        Write-Output "结束本次检查"
    }
}

$missingPath = Join-Path $env:TEMP ("anystack-" + [guid]::NewGuid() + ".json")
Invoke-OrderCheck -Amount 100 -ConfigPath $missingPath

$configPath = Join-Path $env:TEMP "anystack-demo.json"
'{}' | Set-Content -LiteralPath $configPath

try {
    Invoke-OrderCheck -Amount 0 -ConfigPath $configPath
}
finally {
    Remove-Item -LiteralPath $configPath -ErrorAction SilentlyContinue
}

预期输出:

text
开始检查金额:100
配置文件不存在
错误类别:ObjectNotFound
结束本次检查
开始检查金额:0
业务校验失败
异常类型:ArgumentOutOfRangeException
参数名:Amount
结束本次检查

catch 会按从上到下的顺序匹配异常类型,因此应先写具体类型,最后再写不带类型的通用 catch。finally 适合释放文件句柄、关闭连接或删除临时资源,不应承担主要业务逻辑。

读取错误记录中的诊断信息

进入 catch 后,$_ 表示当前的 ErrorRecord,它不只是异常对象。常用诊断字段包括:

  • $_.Exception.Message:底层异常消息
  • $_.Exception.GetType().FullName:异常的完整类型
  • $_.FullyQualifiedErrorId:PowerShell 错误标识
  • $_.CategoryInfo:错误类别、目标对象和原因
  • $_.InvocationInfo.PositionMessage:发生错误的脚本位置
  • $_.ScriptStackTrace:脚本调用栈

记录日志时应优先保存结构化字段,而不是只拼接一段错误文本。这样后续才能按错误类型、命令或脚本位置进行检索和统计。

选择合适的处理策略

能在当前层恢复的错误应在 catch 中修复或返回明确结果;无法恢复的错误可以补充上下文后再次 throw,交给上层统一处理。不要在底层脚本中无条件吞掉异常,否则调用方会误以为任务成功。

-ErrorAction SilentlyContinue 只适合“失败确实可以忽略”的清理动作。若把它用于核心读写或部署命令,触发条件是目标不存在、权限不足或网络失败,后果是脚本继续运行并产生不完整结果。更安全的做法是使用 Stop 捕获错误,或至少检查 $?、返回值和 $LASTEXITCODE。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

处理错误与异常

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通