使用Python Subprocess安装requirements.txt时触发FastAPI 500错误

问题场景 #

用Python subprocess开发自动化脚本，基于FastAPI+Uvicorn实现Django项目自动构建，Python版本3.11。执行到安装requirements.txt步骤时触发FastAPI 500内部错误，错误提示：

{
"error": "Command '['pip', 'install', '-r', 'requirements.txt']' returned non-zero exit status 1."
}

相关核心代码片段：

@app.post("/webhook")
async def webhook(request: Request):
    try:
        
     repo_directory = 'D:/web development/ScratchFb'
     python_directory = 'D:/web development/ScratchFb/fbscratch/backendfb'
     nextjs_directory = 'D:/web development/ScratchFb/fbscratch/fontendfb'
     # 克隆Git仓库
     clone_command = subprocess.run(['git', 'clone', 'https://github_url'], cwd=repo_directory,check=True)

     # 创建虚拟环境
     vertual_venv = subprocess.run(['python', '-m', 'venv', 'venv'], cwd=python_directory ,check=True)
     # 根据系统激活虚拟环境
     if sys.platform == 'win32':
        activate_venv = subprocess.run(['venv\Scripts\activate'], cwd=python_directory , shell=True, check=True)
     else:
        activate_venv = subprocess.run(['source', 'venv/bin/activate'], cwd=python_directory, shell=True, check=True)

     # 安装requirements.txt依赖
     install_req_txt =  subprocess.run(['pip', 'install', '-r', 'requirements.txt'], cwd=python_directory,check=True)
 
     # 安装npm依赖
     npm_i =  subprocess.run(['npm', 'i'], cwd=nextjs_directory,check=True)

     # 检查npm安装是否成功，再执行构建
     if npm_i.returncode == 0:
        npm_build = subprocess.run(['npm', 'run', 'build'], cwd=nextjs_directory, check=True)
     else:
        print("Error: npm install failed.")
    

关键问题分析 #

1. 虚拟环境激活无效：subprocess.run启动的是独立子进程，激活命令仅在该子进程内生效，后续的pip install仍调用系统全局Python，而非虚拟环境里的pip。
2. 缺少错误详情：仅返回退出码，未捕获安装过程中的具体错误日志，无法定位是版本冲突、网络问题还是路径错误。
3. 路径与权限隐患：Windows下路径转义可能出错，或脚本权限不足，导致无法读取requirements.txt或写入虚拟环境目录。

解决步骤 #

1. 直接调用虚拟环境内的pip #

跳过单独激活步骤，直接指定虚拟环境中的pip路径：

• Windows：python_directory/venv/Scripts/pip.exe
• Linux/macOS：python_directory/venv/bin/pip

修改后的安装代码：

# 替换原install_req_txt代码块
import os

if sys.platform == 'win32':
    pip_path = os.path.join(python_directory, 'venv', 'Scripts', 'pip.exe')
else:
    pip_path = os.path.join(python_directory, 'venv', 'bin', 'pip')

install_req_txt = subprocess.run(
    [pip_path, 'install', '-r', 'requirements.txt'],
    cwd=python_directory,
    check=True,
    capture_output=True,  # 捕获输出日志
    text=True
)

2. 捕获并返回详细错误日志 #

在异常处理中打印并返回具体错误信息，方便排查：

from fastapi import HTTPException

@app.post("/webhook")
async def webhook(request: Request):
    try:
        # ... 其他代码 ...
        
        install_req_txt = subprocess.run(
            [pip_path, 'install', '-r', 'requirements.txt'],
            cwd=python_directory,
            check=True,
            capture_output=True,
            text=True
        )
        
        # ... 其他代码 ...
        
    except subprocess.CalledProcessError as e:
        print(f"依赖安装失败详情: {e.stderr}")
        raise HTTPException(status_code=500, detail=f"依赖安装失败: {e.stderr}")

3. 校验路径与权限 #

• 提前检查requirements.txt是否存在：

  req_file = os.path.join(python_directory, 'requirements.txt')
  if not os.path.exists(req_file):
      raise HTTPException(status_code=400, detail="requirements.txt不存在")
  

• Windows下确保脚本有写入venv目录的权限；Linux/macOS若权限不足，可按需添加sudo（需谨慎操作）。

4. 其他优化点 #

• Git克隆前检查目标目录是否存在，避免重复克隆报错；
• 虚拟环境创建前检查是否已存在，跳过重复创建步骤；
• 给pip添加镜像源参数（如-i https://pypi.tuna.tsinghua.edu.cn/simple），解决网络安装缓慢问题。

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