PowerShell调用子脚本判断返回值时主脚本异常退出问题排查

核心问题原因 #

1. return 后的代码永远不会执行
   子脚本中你把exit写在了return语句之后，return会直接终止当前子脚本的运行，后续的exit没有任何执行机会，属于无效代码。

2. 返回值判断逻辑存在漏洞
   你主脚本中使用if (-not $return)作为出错的判断条件，默认前提是「子脚本正常运行一定会返回非空值，只有出错时才返回空值」，但实际情况是：如果子脚本正常执行完成后没有显式返回非空值，$return会自动为空值，哪怕没有触发错误分支，也会命中退出判断，这就是你没进错误逻辑主脚本也退出的核心原因。

3. 返回值容易被子脚本输出污染
   PowerShell中调用子脚本时，子脚本所有成功流（1号流）的输出都会被自动收集到返回结果中，如果你在子脚本中用Write-Output打印了日志，这些内容也会被塞进$return变量，导致判断逻辑完全失真。

4. 额外注意：你主脚本调用2_afleidenParameters.ps1时传递了参数-versieNieuwstLokaal $versieNieuwstLokaal，但当前主脚本代码中没有定义$versieNieuwstLokaal变量，空值传递也可能导致子脚本运行异常。

修复方案 #

方案1：统一返回值约定（适合需要返回业务参数的场景） #

• 所有需要做错误判断的子脚本，正常执行完成后显式返回非空值：不需要返回业务参数的校验类脚本（比如1_checkVoorwaarden.ps1），校验通过后最后一行加return $true；需要返回业务参数的脚本（比如2_afleidenParameters.ps1），正常执行完成后返回你需要的参数数组。
• 子脚本出错时统一返回$false，不需要写多余的exit。
• 子脚本中所有非返回值的日志输出统一用Write-Host或者Write-Verbose，不要走默认的成功流，避免污染返回值。
• 主脚本判断逻辑修改为：

# 校验类脚本判断
$return = .\Subscripts\1_checkVoorwaarden.ps1 # 其他参数省略
if ($return -eq $false) {
    $stopWatch.Stop()
    Read-Host -Prompt "`nHet script is beëindigd. Toets Enter om af te sluiten"
    exit
}

# 带参数返回的脚本判断
$return = .\Subscripts\2_afleidenParameters.ps1 # 其他参数省略
if ($return -eq $false) {
    $stopWatch.Stop()
    Read-Host -Prompt "`nHet script is beëindigd. Toets Enter om af te sluiten"
    exit
} else {
    # 正常取返回的参数逻辑
    if (!$versieSoort) {
        $versieSoort = $return[0]
    }
    $buildMapNetwerk = $return[1]
    $buildPadNetwerk = $return[2]
}

方案2：用退出码判断（更稳定，不受输出干扰） #

不需要捕获子脚本返回值，直接通过退出码判断执行结果：

• 子脚本出错分支写exit 1，正常执行完成写exit 0。
• 主脚本调用后直接判断自动变量$LASTEXITCODE即可：

.\Subscripts\1_checkVoorwaarden.ps1 # 其他参数省略
if ($LASTEXITCODE -ne 0) {
    $stopWatch.Stop()
    Read-Host -Prompt "`nHet script is beëindigd. Toets Enter om af te sluiten"
    exit
}

这种方式不会被子脚本的任何输出内容干扰，判断逻辑更稳定。

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