通过Apache mod-php执行Python脚本异常：CLI正常Web端生成空文件

问题场景 #

通过PHP脚本调用以下Python代码，从指定URL获取XML数据并写入本地文件：

fname='/tmp/catalog.xml'
http=urllib3.PoolManager()
response=http.request('GET','https://xxxx/xxxxx.xml')
doc=response.data.decode('UTF-8')
print('Saving xml...')
with open(fname,'w') as catalog:
    catalog.write(doc)
print('Parsing...')

异常现象 #

• 以sudo -u www-data php -f test.php在CLI环境执行时，脚本运行正常，/tmp/catalog.xml包含有效数据；
• 通过Web浏览器调用同一PHP脚本时，仅输出“Saving xml...”，生成的catalog.xml为空文件，PHP日志无报错，权限配置无异常。

可能的原因及解决方法 #

1. Python环境变量差异（CLI vs Web服务）

Web服务（如Apache/Nginx）运行时的环境变量和CLI下www-data用户的环境变量不同，可能导致Python找不到urllib3库，或是使用了不同的Python版本。

• 解决：在Python脚本开头指定绝对路径的Python解释器（比如#!/usr/bin/python3），或在PHP调用Python时使用绝对路径（如exec('/usr/bin/python3 /path/to/your/script.py')）；
• 验证：在Web环境的PHP脚本里执行exec('which python3 2>&1', $output)，将输出结果和CLI下sudo -u www-data which python3对比，确保二者一致。

2. HTTPS请求在Web环境下静默失败

Web环境可能未配置CA证书，导致urllib3发起HTTPS请求时失败，但原Python脚本未捕获异常，直接继续执行写入空字符串。

• 解决：修改Python脚本，添加异常捕获并输出错误信息：

import urllib3
from urllib3.exceptions import RequestError

fname='/tmp/catalog.xml'
try:
    http=urllib3.PoolManager()
    response=http.request('GET','https://xxxx/xxxxx.xml')
    # 检查响应状态码
    if response.status != 200:
        print(f"Request failed with status: {response.status}")
        exit(1)
    doc=response.data.decode('UTF-8')
    print('Saving xml...')
    with open(fname,'w') as catalog:
        catalog.write(doc)
    print('Parsing...')
except RequestError as e:
    print(f"Request error: {str(e)}")
except Exception as e:
    print(f"Unexpected error: {str(e)}")

Web调用时查看输出的错误信息，判断是证书问题还是网络访问限制。如果是证书问题，可在PoolManager中指定CA证书路径，或临时关闭证书验证（仅测试用，不推荐生产环境）：http=urllib3.PoolManager(cert_reqs='CERT_NONE')。

3. PHP未捕获Python脚本的错误输出

Web环境下PHP调用Python时，可能未捕获标准错误输出，导致异常被隐藏。

• 解决：在PHP调用Python的代码中，捕获标准错误输出，示例：

$output = [];
$return_var = 0;
exec('/usr/bin/python3 /path/to/script.py 2>&1', $output, $return_var);
var_dump($output);
var_dump($return_var);

通过$output查看Python脚本的错误信息，$return_var非0则说明脚本执行出错。

4. /tmp目录的临时文件冲突或锁定

虽然权限配置无异常，但Web环境下可能存在同名临时文件被锁定，或是/tmp的sticky bit导致写入问题（概率较低）。

• 解决：修改Python脚本，生成唯一文件名，示例：

import tempfile
fname = tempfile.mktemp(suffix='.xml', dir='/tmp')

或指定其他www-data有写入权限的目录，比如/var/www/tmp。

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