命令行与文本处理 / 系统课时
处理错误与异常
处理错误与异常
本课解决 PowerShell 脚本在命令失败、业务校验不通过或资源需要清理时如何保持可控执行的问题。完成后,你能把非终止错误转换为可捕获异常,并从错误记录中提取可用于日志和排障的关键信息。
学习目标
- 区分终止错误与非终止错误,理解
ErrorAction的作用范围 - 使用
try、catch、finally和throw组织失败流程 - 从错误记录中提取异常类型、错误类别和调用位置
区分非终止错误与终止错误
PowerShell 的很多 cmdlet 遇到单个对象失败时,默认会报告错误后继续处理,这类错误称为非终止错误。它不会自动进入 catch,因此只写 try 和 catch 仍可能捕获不到失败。
对当前命令使用 -ErrorAction Stop,可以把非终止错误提升为终止错误,使控制流立即跳入 catch。ErrorAction 是 cmdlet 的公共参数,不会自动把原生可执行程序的非零退出码变成异常;调用外部程序后还要检查 $LASTEXITCODE。
建立完整的异常处理流程
下面的脚本演示两种失败:读取不存在的配置文件,以及主动使用 throw 拒绝非法金额。两个分支最终都会执行 finally。
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
}预期输出:
开始检查金额: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。