根本原因是PHP调用的Python解释器环境与开发终端不一致，需确认真实路径（python3 -c "import sys; print(sys.executable)"），用对应python -m pip安装依赖，并确保Web用户权限、绝对路径、错误捕获及SELinux等配置正确。
PHP 调用 python 脚本时报 “ModuleNotFoundError” 或 “No module named XXX”，根本原因不是 PHP 问题，而是 PHP 进程启动的 Python 解释器环境跟你的开发终端不一致——它用的是系统默认或指定路径下的 Python，而那个环境没装你要的包。
确认 PHP 实际调用的是哪个 Python
别猜，直接在 PHP 里打印出来：
<?php
$output = shell_exec('which python3 2>&1');
echo "Python path: " . trim($output);
?>
常见情况包括：/usr/bin/python3（系统自带）、/usr/local/bin/python3（brew/macports）、/opt/homebrew/bin/python3（Apple Silicon Mac），甚至可能是 /var/www/.pyenv/shims/python（如果你用了 pyenv 但没全局生效）。
- 如果输出为空或报错，说明
python3不在 PATH 中，需显式指定绝对路径（如/usr/local/bin/python3） - PHP 的
shell_exec、exec等函数运行在 Web 服务器用户（如www-data、_www）下，该用户家目录、PATH、shell 配置都和你登录终端不同 -
which python3结果 ≠python3 -c "import sys; print(sys.executable)"，后者才是真实解释器路径，更准
给正确的 Python 安装依赖（不是 pip，是 pip3 对应那个 python3）
拿到上一步的真实路径后，用它来调 pip3，或者更稳妥：用 -m pip 模式安装：
立即学习“PHP免费学习笔记（深入）”；
/usr/bin/python3 -m pip install requests numpy pandas
不要用 pip3 install xxx，因为 pip3 可能指向另一个 Python 环境。
- 如果提示
pip未安装：先/usr/bin/python3 -m ensurepip --upgrade - 若权限不足（比如
www-data用户不能写/usr/lib/python3.x/site-packages），改用--user：/usr/bin/python3 -m pip install --user requests，然后确保该用户的PYTHONPATH或site-packages目录被 Python 加载（可通过python3 -c "import site; print(site.getusersitepackages())"查） - 虚拟环境？别让 PHP 去激活 venv，直接用虚拟环境里的 Python 全路径调用：
/var/www/myproject/venv/bin/python script.py
PHP 调用时避免路径和编码陷阱
即使模块装对了，PHP 执行仍可能失败：
- 脚本路径用绝对路径，别写
./script.py—— PHP 当前工作目录通常是 Web 根目录，不是你放 PY 文件的地方 - 加
2>&1捕获错误：exec('/usr/bin/python3 /var/www/script.py 2>&1', $output, $return_code)，否则 Python 的 ImportError 会被静默吞掉 - 中文路径或参数？用
escapeshellarg()包裹每个参数，否则空格、括号、$ 符号都会出问题 - Linux 下注意 SELinux 或 AppArmor 限制（尤其 CentOS/RHEL），可能禁止 Apache/Nginx 子进程执行 Python；临时测试可
setenforce 0看是否恢复
最常被忽略的一点：Web 服务器用户（如 www-data）没有读取你 Python 脚本所在目录的权限，或者脚本里用了相对路径打开文件——错误表现也是 ModuleNotFoundError（比如 import 同目录的 utils.py 失败），实际是 ImportError: attempted relative import with no known parent package 或直接 Permission denied。得检查整个调用链的文件权限、目录可执行位、以及 Python 的 sys.path 是否包含脚本所在目录。
