PHP调用Python脚本引入第三方库无输出的问题排查与解决

核心原因分析 #

当导入pandas/lxml/suds这类第三方库后脚本无输出，本质是第三方库未安装、Python环境不匹配或运行权限不足导致脚本执行失败，但shell_exec默认只捕获标准输出，错误信息被丢弃，所以PHP收不到任何内容。

调试步骤 #

• 直接在终端执行脚本，查看报错
  用PHP调用的Python路径直接运行脚本，比如：

  /usr/bin/python3 /opt/bitnami/apache/htdocs/test/script.py 123
  

  终端会直接显示脚本执行的错误（比如ModuleNotFoundError），这是最快定位问题的方式。

• 修改PHP命令，捕获错误输出
  在PHP中把Python的错误输出重定向到标准输出，同时给参数做转义避免命令注入风险：

  <?php
  header('Content-Type: application/json');
  header('Access-Control-Allow-Origin: *');
  header('Access-Control-Allow-Methods: POST');
  header('Access-Control-Allow-Headers: Content-Type, Access-Control-Allow-Methods, Access-Control-Allow-Headers, Authorization, X-Requested-With');
  
  $data = json_decode(file_get_contents("php://input"), true);
  $externalUserId = $data['externalUserId'];
  
  $command = '/usr/bin/python3 /opt/bitnami/apache/htdocs/test/script.py ' . escapeshellarg($externalUserId) . ' 2>&1';
  $output = shell_exec($command);
  echo json_encode(['result' => $output]);
  ?>
  

  调用API后就能看到Python的报错信息。

• 检查Python环境的包安装情况
  确认PHP调用的Python环境是否已安装所需库：

  /usr/bin/python3 -m pip list
  

  如果列表里没有pandas/lxml/suds，说明未安装。

• 验证Apache运行用户的执行权限
  Bitnami环境中Apache通常以bitnami用户运行，切换到该用户执行脚本，排查权限问题：

  sudo -u bitnami /usr/bin/python3 /opt/bitnami/apache/htdocs/test/script.py 123
  

解决方案 #

• 安装缺失的第三方库
  用PHP调用的Python环境安装所需包（Bitnami环境需指定运行用户）：

  sudo -u bitnami /usr/bin/python3 -m pip install pandas lxml suds
  

  如果遇到全局权限问题，可添加--user参数安装到用户目录：

  sudo -u bitnami /usr/bin/python3 -m pip install --user pandas lxml suds
  

• 确保Python环境一致
  如果你之前是用虚拟环境安装的库，需在PHP中指定虚拟环境的Python路径，比如：

  $command = '/path/to/your/venv/bin/python /opt/bitnami/apache/htdocs/test/script.py ' . escapeshellarg($externalUserId) . ' 2>&1';
  

• 在Python脚本中添加错误捕获
  主动捕获导入错误并输出，方便后续排查：

  import sys
  import traceback
  
  try:
      import pandas as pd
      from lxml import etree as et
      from suds.client import Client
  except ImportError as e:
      print(f"导入失败: {str(e)}")
      traceback.print_exc(file=sys.stdout)
      sys.exit(1)
  
  playerId = sys.argv[1]
  print('Player ID is ' + playerId)
  

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