PowerShell运行SQL脚本时Try/Catch错误捕获失效问题

• 第一，Invoke-SqlCmd 默认执行时遇到连接错误、SQL语法错误、权限错误只会输出报错文本，不会触发PowerShell的错误终止机制，后续代码会继续运行，根本不会进入异常分支。
• 第二，你写的$Output.uri -eq '0'判断逻辑完全不成立：Invoke-SqlCmd的返回结果不存在uri这个字段，执行报错时$Output是$null空值，这个判断条件永远不会按预期触发，很容易因为变量残留、之前会话的旧赋值误返回true。

必须给命令加上-ErrorAction Stop参数，把所有非终止错误转换成可被try/catch捕获的终止错误，同时开启SQL错误输出，才能完整覆盖所有异常场景：

$isconnected = $false

try {
    # 核心参数说明：
    # -ErrorAction Stop：将所有类别的错误转为终止错误，触发catch块捕获
    # -OutputSqlErrors $true：确保SQL层面的报错（语法错误、权限不足、对象不存在等）也能正常抛出
    $Output = Invoke-SqlCmd `
        -ServerInstance $dbinstance `
        -Username $dbusername `
        -Password $dbpassword `
        -Database $dbname `
        -Query $Query `
        -ErrorAction Stop `
        -OutputSqlErrors $true

    # 走到这一步说明命令执行没有抛出任何错误，状态标记为成功
    $isconnected = $true
    Write-Host -ForegroundColor Green "数据库连接、SQL脚本执行成功"
}
catch {
    # 捕获到任意错误都标记为失败，可直接输出错误详情排查问题
    $isconnected = $false
    Write-Host -ForegroundColor Red "执行失败，错误信息：$($_.Exception.Message)"
}

• 不要依赖返回结果的自定义字段判断执行状态，只要Invoke-SqlCmd运行时没有抛出异常，就代表连接和脚本执行成功，不会出现漏判。
• 如果使用的是较旧版本的SQL Server模块，可额外添加-ConnectionTimeout 10参数设置10秒连接超时，避免异常场景下长时间无响应。
• 登录失败、SQL执行报错、连接超时这类常见问题，都会被上述catch块正常捕获，不会再出现明确报错但仍返回true的问题。

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