如何查看通过PHP shell_exec()调用的Python代码报错？

当PHP通过shell_exec()调用Python脚本时，默认只能捕获Python的标准输出（stdout），错误输出（stderr）会被丢弃，导致看不到报错信息。以下是几种实用的排查方法：

• 重定向错误输出到标准输出
  在Python命令后添加2>&1，将错误输出合并到标准输出中，这样shell_exec()就能返回错误信息。示例PHP代码：

  $arg = escapeshellarg($your_parameter); // 务必转义参数避免注入
  $output = shell_exec("python3 /path/to/your_script.py {$arg} 2>&1");
  echo $output; // 打印包含错误的输出内容
  

• 将错误写入日志文件
  把错误输出定向到指定日志文件，方便后续查看。注意要确保PHP运行用户（如www-data）对日志文件有写入权限：

  $arg = escapeshellarg($your_parameter);
  shell_exec("python3 /path/to/your_script.py {$arg} 2>/var/log/python_script_errors.log");
  

  之后直接查看日志文件：cat /var/log/python_script_errors.log

• 在Python脚本内捕获异常并记录
  在Python代码中添加异常捕获逻辑，主动将错误信息写入日志，能更精准地定位问题：

  import sys
  import traceback
  from datetime import datetime
  
  try:
      # 处理传入参数
      if len(sys.argv) < 2:
          raise ValueError("缺少必要参数")
      arg = sys.argv[1]
      # 你的业务逻辑代码
      # ...
  except Exception as e:
      with open('/var/log/python_script_errors.log', 'a', encoding='utf-8') as f:
          log_time = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
          f.write(f"[{log_time}] 错误信息: {str(e)}\n")
          f.write(f"[{log_time}] 调用栈:\n{traceback.format_exc()}\n\n")
  

• 模拟Web用户环境在命令行测试
  PHP通常以Web服务器用户（如www-data）身份运行，可能与你登录用户的环境、权限不同。用以下命令模拟运行，直接查看错误：

  sudo -u www-data python3 /path/to/your_script.py "测试参数"
  

  这种方法能快速排查权限不足、模块缺失、路径错误等环境相关问题。

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