通过subprocess.Popen调用批处理文件时Python脚本未执行问题

核心问题 #

直接在CMD中运行run_process.bat时一切正常，但通过FastAPI端点调用subprocess.Popen执行该批处理文件时，其中的test2.py脚本未生效，批处理的其他操作（如设置PYTHONPATH）已执行。

排查与解决步骤 #

1. 捕获错误输出，定位具体问题 #

当前批处理仅重定向了标准输出到日志，错误输出未被记录，导致Python脚本执行失败的原因无法追踪。修改批处理文件，将标准错误也写入日志：

set PYTHONPATH=c:\GPT\lib 
c:\GPT\gptenv\Scripts\python.exe c:\GPT\gis\test2.py >> c:\tmp\logs.txt 2>&1

执行后查看c:\tmp\logs.txt，确认是否有Python执行时的报错信息（如模块找不到、权限不足等）。

2. 调整subprocess调用方式，捕获执行日志 #

在Python代码中，修改subprocess.Popen的调用参数，捕获批处理执行的输出和错误，方便在FastAPI日志中查看：

def run_process_project_thread(self, project_name, websocket_queue):
    # ... 原有代码 ...
    proc = subprocess.Popen(
        ['cmd.exe', '/c', fr'C:\ProgramData\axioma\gpt\run_process.bat', fr'C:\ProgramData\axioma\gpt\Projects\TalTest'],
        stdout=subprocess.PIPE,
        stderr=subprocess.PIPE,
        text=True
    )
    stdout, stderr = proc.communicate()
    print(f"Batch STDOUT: {stdout}")
    print(f"Batch STDERR: {stderr}")

运行FastAPI后触发端点，查看控制台输出的日志，定位批处理执行中的异常。

3. 检查权限问题 #

FastAPI运行的用户（如Windows服务账户、当前登录用户）可能没有以下权限：

• 读取c:\GPT\gis\test2.py文件的权限
• 执行c:\GPT\gptenv\Scripts\python.exe的权限
• 写入c:\tmp\logs.txt的权限

右键相关文件/目录，进入“属性-安全”选项卡，确保运行FastAPI的用户拥有对应的读写/执行权限。

4. 确保虚拟环境正确加载 #

虽然直接调用虚拟环境的Python可执行文件，但部分场景下可能需要先激活虚拟环境。修改批处理文件，添加虚拟环境激活步骤：

set PYTHONPATH=c:\GPT\lib 
call c:\GPT\gptenv\Scripts\activate.bat
python.exe c:\GPT\gis\test2.py >> c:\tmp\logs.txt 2>&1

注意使用call命令，否则批处理会在激活虚拟环境后直接退出，无法执行后续Python脚本。

5. 指定工作目录 #

FastAPI运行时的工作目录可能与CMD中不同，导致批处理执行时路径异常。在subprocess.Popen中指定批处理所在的目录作为工作目录：

proc = subprocess.Popen(
    ['cmd.exe', '/c', 'run_process.bat', fr'C:\ProgramData\axioma\gpt\Projects\TalTest'],
    cwd=r'C:\ProgramData\axioma\gpt',
    stdout=subprocess.PIPE,
    stderr=subprocess.PIPE,
    text=True
)

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