Python与PowerShell中正确捕获错误码的问题排查

核心原因分析 #

你的问题本质是PowerShell脚本的错误退出码没有正确向上传递，导致上层的第一个脚本和Python应用都拿到了默认的0退出码，进而错误返回HTTP 200。具体诱因集中在这几点：

• 第二个脚本里的除零错误属于PowerShell的非终止错误，默认不会改变进程退出码
• 第一个脚本调用第二个脚本时，没有主动捕获并传递其退出码
• PowerShell默认配置会忽略部分错误，不会自动设置非零退出码

分步排查与修复 #

1. 让第二个脚本抛出终止错误并设置退出码 #

PowerShell里普通的除零操作（比如1/0）属于非终止错误，不会让脚本以非零码退出。你需要把它改成终止错误，或者手动指定退出码：

# 第二个脚本示例：捕获错误并手动设置退出码
try {
    $null = 1/0
}
catch {
    Write-Error $_.Exception.Message  # 输出错误信息，方便上层捕获
    exit 1  # 手动设置非零退出码，可根据需求改成其他值比如2、3
}

或者更直接，用全局配置让所有错误变成终止错误：

$ErrorActionPreference = 'Stop'  # 开启后任何错误都会终止脚本
$null = 1/0  # 这里的除零错误会直接触发脚本退出，默认返回退出码1

2. 第一个脚本必须捕获并传递第二个脚本的退出码 #

如果第一个脚本只是简单调用第二个脚本（比如.\second_script.ps1），它不会自动把第二个脚本的退出码作为自己的退出码，需要显式处理：

# 第一个脚本调用第二个脚本的正确写法
& .\second_script.ps1  # 用&调用才能正确捕获后续的$LASTEXITCODE
$secondExitCode = $LASTEXITCODE

# 如果第二个脚本退出码非零，第一个脚本也以相同码退出
if ($secondExitCode -ne 0) {
    exit $secondExitCode
}

3. Python调用PowerShell的正确姿势 #

确保在Python里调用第一个脚本时，正确获取退出码并判断。用subprocess.run的示例：

import subprocess
from fastapi import FastAPI
from fastapi.responses import JSONResponse

app = FastAPI()

@app.post("/your-api-endpoint")
async def your_api():
    result = subprocess.run(
        ["powershell", "-ExecutionPolicy", "Bypass", "-File", "first_script.ps1"],
        capture_output=True,
        text=True,
        encoding="utf-8"
    )
    # 根据退出码返回对应HTTP状态码
    if result.returncode != 0:
        return JSONResponse(content={"error": result.stderr.strip()}, status_code=400)
    return JSONResponse(content={"message": "操作成功"}, status_code=200)

注：-ExecutionPolicy Bypass是为了避免脚本执行权限限制，可根据你的环境调整。

4. 解决第二个脚本的UTF-8编码问题 #

要让第二个脚本以UTF-8执行，可在脚本开头设置编码：

# 第二个脚本开头添加，强制输出UTF-8编码
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8

或者在第一个脚本调用时指定编码参数：

& powershell -NoProfile -ExecutionPolicy Bypass -File .\second_script.ps1 -OutputEncoding utf8

验证步骤 #

1. 单独运行第二个脚本，执行后在PowerShell里输入$LASTEXITCODE，确认返回非零值（比如1）
2. 运行第一个脚本，同样检查$LASTEXITCODE，确认和第二个脚本的退出码一致
3. 在Python里调用第一个脚本，打印result.returncode，确认非零，此时API就能正确返回错误状态码

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