php调用python脚本失败主因是环境不一致：web服务器用户权限不足、path未加载、python路径非绝对、虚拟环境未激活、cron环境极简、stdout未刷新、locale编码不匹配；需统一用绝对路径、显式声明环境变量、强制输出刷新、设置utf-8 locale。
PHP调用Python脚本的常见失败原因
直接用 exec() 或 shell_exec() 跑 python script.py 很容易卡住或没输出，不是PHP问题，而是环境不一致导致的：Web服务器（如Apache/Nginx）跑PHP时用的是 nobody/www-data 用户，它通常没权限读你的Python环境、没加载 PATH、甚至找不到 python 命令。
- 检查实际执行用户：
exec('whoami', $out); print_r($out); - 别写
python script.py，改用绝对路径：/usr/bin/python3 /var/www/script.py - Python脚本开头加
#!/usr/bin/env python3没用——PHP不走shebang，得靠shell解释器显式调用 - 如果Python脚本依赖虚拟环境，必须激活后再运行，例如：
/path/to/venv/bin/python /path/to/script.py
cron里跑PHP触发Python为什么总不生效
cron默认环境极简，$PATH 通常只有 /usr/bin:/bin，且不读取用户shell配置（~/.bashrc），所以即使你在终端能跑通，cron里大概率报错 command not found: python 或 ModuleNotFoundError。
- 在crontab里写完整路径：
* * * * * /usr/bin/php /var/www/run_python.php >> /tmp/pylog.log 2>&1 -
run_python.php里也必须用绝对路径调用Python和脚本，不能依赖相对路径 - 加环境变量声明更稳妥（放在crontab每行开头）：
PATH=/usr/local/bin:/usr/bin:/bin PYTHONIOENCODING=utf-8 - 测试cron环境：临时加一行
* * * * * env > /tmp/cron_env.txt，对比你手动执行env的输出差异
PHP exec() 返回空但Python脚本其实执行了
这是最隐蔽的问题：脚本确实跑了，但PHP收不到输出，因为Python stdout 默认行缓冲，而 exec() 等函数只等进程退出后一次性读取——如果Python脚本没主动刷缓存或没退出，PHP就一直卡着或返回空数组。
- Python端强制刷新输出：
print("done"); import sys; sys.stdout.flush() - 或者启动时加
-u参数禁用缓冲：/usr/bin/python3 -u /path/to/script.py - 用
proc_open()替代exec()，能实时读流、设超时、捕获stderr：$proc = proc_open('python3 -u script.py', [...], $pipes); - 注意
exec()默认不返回stderr，要显式重定向：exec('python3 script.py 2>&1', $output)
定时任务里Python报编码错误或中文乱码
Linux系统locale常为 C，Python 3 在非UTF-8 locale下处理中文字符串会抛 UnicodeEncodeError，尤其当脚本打印日志、读写文件或调用含中文路径的API时。
立即学习“PHP免费学习笔记（深入）”；
- 在crontab里设置locale：
LANG=en_US.UTF-8 LC_ALL=en_US.UTF-8 * * * * php ... - Python脚本开头加：
import locale; locale.setlocale(locale.LC_ALL, 'en_US.UTF-8') - 更彻底：PHP中用
putenv('LANG=en_US.UTF-8')和setlocale(LC_ALL, 'en_US.UTF-8')再调用Python - 避免依赖系统locale：Python里所有文件操作都显式指定
encoding='utf-8'
真正麻烦的从来不是“怎么写定时任务”，而是环境隔离带来的隐性差异——Web请求、命令行、cron三者用的不是同一套环境变量、用户权限、Python路径和locale。盯住这四个点，比背命令重要得多。
