Laravel控制器仅Debian生产环境执行Python脚本无响应，本地运行正常

问题核心原因 #

你遇到的问题本质是PHP执行shell命令的环境和你手动登录服务器的shell环境不一致，最常见的触发原因有以下几类，按排查优先级排序：

1. 运行用户权限差异 #

Debian环境下Laravel应用通常由Nginx/Apache配合PHP-FPM运行，默认执行PHP代码的用户是www-data，和你手动SSH登录用的账号（root/个人账号）权限完全不同：

• 首先确认www-data用户对send_command.py有可读权限，可执行命令chmod o+r /path/to/send_command.py授权
• 若你的Python脚本涉及操作串口、外设、其他受限目录/文件，www-data默认没有访问权限：比如访问串口需要将www-data加入dialout用户组，执行usermod -a -G dialout www-data后重启PHP-FPM服务生效
• 测试基础权限：先执行一段极简命令验证用户身份和基础调用能力，打印返回结果即可确认：

// 查看PHP运行用户
exec('whoami 2>&1', $output, $ret);
var_dump($output, $ret);

// 测试Python是否能正常调用，先把`which python3`返回的绝对路径替换下面的路径
exec('/usr/bin/python3 --version 2>&1', $output, $ret);
var_dump($output, $ret);

2. 错误输出未捕获 #

你当前的写法只能捕获命令的标准输出（stdout），Python脚本运行报错的内容会输出到标准错误流（stderr），默认不会被exec捕获，所以看不到具体报错信息。只需要在命令末尾加2>&1把错误流重定向到标准输出，就能拿到具体错误：

// 修改后的调用代码，注意替换成你的Python3绝对路径
exec('timeout 10 /usr/bin/python3 ' . public_path('send_command.py') . ' -c ' . escapeshellarg($command)  . ' -s ' . escapeshellarg($serial) . ' 2>&1', $output, $result);
// 打印输出即可看到具体报错：比如缺少依赖、权限不足、参数错误等
var_dump($output);

3. 环境变量不匹配 #

手动登录的shell会加载完整的用户环境变量，而PHP执行shell时的环境变量是极简配置：

• 不要直接写python3，要用绝对路径（执行which python3获取实际路径，比如/usr/bin/python3），避免PHP的PATH变量找不到Python执行文件
• 如果你的Python脚本用到了第三方依赖，确认依赖是全局安装的：如果之前是用pip install xxx --user安装的，只有你的登录用户能访问，www-data读不到对应依赖包，需要用sudo pip3 install xxx全局安装依赖
• 建议显式指定工作目录再执行脚本，避免相对路径引用错误：

$scriptPath = public_path('send_command.py');
$cmd = sprintf('cd %s && timeout 10 /usr/bin/python3 %s -c %s -s %s 2>&1',
    dirname($scriptPath),
    basename($scriptPath),
    escapeshellarg($command),
    escapeshellarg($serial)
);
exec($cmd, $output, $result);

4. 其他低概率原因 #

• 检查php.ini中的disable_functions配置，确认exec、shell_exec没有被禁用
• 确认timeout命令的绝对路径，部分精简环境可能没有把timeout所在目录加入PHP的PATH，同样可以换成绝对路径调用

exec执行命令和直接命令行运行的核心差异 #

• 运行身份不同：直接命令行运行使用当前登录用户身份，PHP执行命令使用Web服务对应的运行用户（通常为www-data）
• 环境变量不同：PHP执行shell时仅加载极简的系统环境变量，不会加载登录用户的私有环境配置（包括PATH、Python依赖路径等）
• 权限范围不同：运行用户的权限、所属用户组完全不同，对文件、设备、系统资源的访问限制有明显差异
• 输出规则不同：exec默认仅捕获标准输出流，错误输出默认会被丢弃，需要手动重定向才能捕获

内容的提问来源于stack exchange，提问作者Fabio R.