Nginx环境下含Web请求的Python脚本Web调用无结果问题排查

核心原因 #

命令行与Web服务器的运行环境存在本质差异：Web服务器通过PHP执行脚本时，使用的是www-data（或对应系统的nginx/apache专属用户），该用户的环境变量、网络权限、依赖路径均与你命令行登录的个人用户不同。

具体排查与修复步骤 #

1. 捕获Python脚本的错误输出
   shell_exec默认仅捕获标准输出，错误信息会被丢弃。修改PHP调用命令，将错误输出重定向到标准输出，直接查看具体报错：

$output = shell_exec('python3 /绝对路径/你的脚本.py 2>&1');
var_dump($output); // 打印完整输出，定位错误点

常见报错包括：API密钥未配置、网络访问被拦截、依赖包缺失等。

2. 同步环境变量
   命令行能正常调用API，是因为你的个人用户环境中配置了OPENAI_API_KEY，但Web用户www-data无此变量。解决方式三选一：

• 测试场景：直接在Python脚本中硬编码API密钥；
• 生产场景：编辑/etc/environment添加OPENAI_API_KEY=你的密钥，重启Nginx和PHP-FPM；
• 临时场景：在PHP调用时直接传递变量：

$output = shell_exec('OPENAI_API_KEY=你的密钥 python3 /绝对路径/你的脚本.py 2>&1');

3. 验证Web用户的网络权限
   部分服务器会限制Web用户的对外网络访问，切换到www-data用户测试网络连通性：

sudo -u www-data curl https://api.openai.com/v1/models/text-davinci-003

若curl失败，需调整防火墙规则，或为Web用户配置代理。

4. 统一Python依赖环境
   命令行使用的Python版本与Web用户调用的可能不一致，导致openai等依赖包未安装在对应环境中。先在Python脚本开头打印当前Python路径：

import sys
print(sys.executable)

然后用该路径为www-data安装依赖：

sudo -u www-data /打印出的Python路径 -m pip install openai

5. 检查文件/目录权限
   若Python脚本需要读写临时文件，需确保www-data对目标目录有读写权限：

sudo chown -R www-data:www-data /临时文件目录路径
sudo chmod -R 755 /临时文件目录路径

额外优化建议 #

• 尽量避免通过shell_exec中转调用，直接用PHP的curl或file_get_contents调用OpenAI API，减少中间环节，降低排查复杂度；
• 开启PHP错误日志（修改php.ini的error_log配置项），便于追踪PHP执行阶段的隐性错误。

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