命令行正常的Shell脚本通过PHP触发时Python执行失败求助

这种情况真的太常见了——命令行跑起来一切正常，但通过PHP调用就掉链子，核心原因基本都是运行环境差异或者权限问题，咱们一步步来排查解决：

1. 先抓错误日志：搞清楚到底哪里错了 #

PHP调用脚本时看不到命令行的实时错误输出，所以第一步必须把错误信息捕获下来，这是排查的关键。

方式一：修改Shell脚本记录错误 #

把脚本里的Python执行行改成这样，把输出和错误都写到日志文件里：

/usr/bin/python update.py >> /var/log/setupcamp_exec.log 2>&1

记得先给日志文件配置好www-data的写入权限：

touch /var/log/setupcamp_exec.log
chown www-data:www-data /var/log/setupcamp_exec.log

方式二：在PHP里捕获执行结果 #

完善你的PHP代码，捕获脚本的返回值和输出，方便直接查看问题：

<?php
// 一定要用escapeshellarg转义参数，避免命令注入风险！
$campName = escapeshellarg($_POST['sl']);
$secondParam = escapeshellarg($_POST['param2']); // 对应脚本里的$2参数
$command = dirname(__FILE__) . '/setupcamp.sh ' . $campName . ' ' . $secondParam;

// 捕获脚本输出和返回码
exec($command, $outputLines, $returnCode);

// 打印结果（线上环境建议写到日志文件而非直接输出）
echo "脚本返回码: " . $returnCode . "<br>";
echo "脚本输出: <pre>" . implode("\n", $outputLines) . "</pre>";
?>

返回码非0就说明脚本执行出错了，输出内容里会有具体的错误提示（比如Python找不到依赖模块、权限不足等）。

2. 最常见的坑：环境变量差异 #

命令行里你用的是自己的用户（比如toomanycooks），而PHP通常以www-data用户运行，两者的环境变量完全不同——哪怕你用了/usr/bin/python绝对路径，Python依赖的模块路径可能还是不对。

解决方法： #

• 显式设置Python模块路径：先在命令行运行echo $PYTHONPATH，把得到的路径加到Shell脚本开头：

  #!/bin/bash
  # 导入命令行用户的Python模块路径
  export PYTHONPATH="/home/toomanycooks/.local/lib/python3.8/site-packages:$PYTHONPATH"
  

• 切换用户执行Python：如果不想折腾环境变量，可以让www-data切换到toomanycooks用户身份执行Python：

  su toomanycooks -c "/usr/bin/python /home/toomanycooks/whitewaterwriters.com/$1/workingDirectory/update.py"
  

  注意：需要给www-data配置免密su/sudo权限（可以修改/etc/sudoers实现，记得用visudo编辑避免语法错误）。

3. 权限问题：www-data没权限访问文件 #

www-data用户可能没有读取update.py的权限，或者没有写入list.csv的权限，甚至连切换到目标目录的权限都没有。

检查并修复权限： #

• 给工作目录添加读/执行权限：

  chmod -R o+rX /home/toomanycooks/whitewaterwriters.com
  

• 给list.csv添加写入权限：

  chmod o+w /home/toomanycooks/whitewaterwriters.com/Driver/list.csv
  

• 更安全的做法：把www-data加入到toomanycooks用户组，用组权限控制访问：

  usermod -aG toomanycooks www-data
  chmod -R g+rX /home/toomanycooks/whitewaterwriters.com
  chmod g+w /home/toomanycooks/whitewaterwriters.com/Driver/list.csv
  

  这样既不用开放所有人权限，又能让www-data正常访问文件。

4. 工作目录陷阱：cd命令可能悄悄失败 #

脚本里的cd $1/workingDirectory可能因为参数错误、目录不存在或权限问题失败，但脚本没做错误检查，导致后面的Python脚本用相对路径执行时找不到文件。

解决方法： #

给cd命令加错误检查，并且用绝对路径执行Python：

cd $1/workingDirectory || { 
  echo "[$(date)] 无法切换到目录: $1/workingDirectory" >> /var/log/setupcamp_error.log
  exit 1
}
# 用绝对路径执行update.py，彻底避免相对路径问题
/usr/bin/python /home/toomanycooks/whitewaterwriters.com/$1/workingDirectory/update.py

5. PHP本身的限制 #

最后检查一下PHP配置，看看是不是被限制了执行命令：

• 打开php.ini，检查disable_functions里有没有exec、system、passthru这些函数，如果有就去掉；
• 检查open_basedir设置，确保允许访问你的脚本和相关目录，若有需要就添加对应路径。

按照这个步骤排查，基本能定位并解决问题——先抓错误日志，明确是环境、权限还是路径的问题，再针对性修复即可。

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