Python Pillow包在命令行可用但Apache/WSGI环境下无法运行的问题

可能的原因及对应解决方法 #

1. 检查Apache进程的权限 #

Apache默认以www-data用户运行，若虚拟环境中Pillow的扩展模块文件权限不足，会导致进程无法读取。

• 查看Pillow核心模块的权限：

  ls -l /var/www/app/env/lib/python3.9/site-packages/PIL/_imaging.cpython-39-x86_64-linux-gnu.so
  

• 若文件所有者为个人用户而非www-data，修改权限：

  sudo chown -R www-data:www-data /var/www/app/env/lib/python3.9/site-packages/PIL/
  

  或放宽文件可读性：

  sudo chmod -R 755 /var/www/app/env/lib/python3.9/site-packages/PIL/
  

2. 补全系统编译依赖 #

Pillow的C扩展模块依赖系统底层库，若编译时缺失依赖，会导致_imaging模块未正确生成。

• 安装Pillow所需的系统依赖：

  sudo apt-get install libjpeg-dev zlib1g-dev libpng-dev libtiff-dev libwebp-dev
  

• 重新在虚拟环境中编译安装Pillow：

  source /var/www/app/env/bin/activate
  pip uninstall -y pillow
  pip install pillow --no-cache-dir
  

3. 验证WSGI模块与Python版本匹配 #

即使安装了libapache2-mod-wsgi-py3，也可能存在模块关联的Python版本与虚拟环境3.9不匹配的情况。

• 检查WSGI模块对应的Python版本：

  mod_wsgi-express module-config
  

• 若版本不一致，重新编译适配虚拟环境的WSGI模块：

  # 卸载原有模块
  sudo apt-get remove libapache2-mod-wsgi-py3
  # 安装编译依赖
  sudo apt-get install apache2-dev python3.9-dev
  # 在虚拟环境中安装mod-wsgi
  source /var/www/app/env/bin/activate
  pip install mod-wsgi
  # 生成模块配置并添加到Apache
  mod_wsgi-express module-config | sudo tee /etc/apache2/mods-available/wsgi.conf
  # 启用模块并重启Apache
  sudo a2enmod wsgi
  sudo systemctl restart apache2
  

4. 完善Apache的WSGI路径配置 #

仅设置WSGIPythonHome可能不够，需同时指定应用目录和虚拟环境包路径：

WSGIPythonHome "/var/www/app/env"
WSGIPythonPath "/var/www/app:/var/www/app/env/lib/python3.9/site-packages"

修改后重启Apache：

sudo systemctl restart apache2

5. 验证虚拟环境内Pillow的完整性 #

先确认虚拟环境中的Pillow本身无问题：

source /var/www/app/env/bin/activate
python -c "from PIL import _imaging; print('模块加载成功')"

若此步骤报错，说明虚拟环境构建存在问题，需彻底删除虚拟环境后重新创建并安装所有依赖。

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