AWS ElasticBeanstalk部署的Django应用出现The _imagingft C module is not installed错误的解决求助

你遇到的核心问题是Pillow在编译阶段没有正确链接到系统的freetype库——虽然你已经通过yum安装了freetype-devel，但Pillow可能从pip缓存中直接安装了预编译的wheel包，跳过了依赖系统库的编译步骤，导致_imagingft模块缺失。下面是具体的解决步骤：

1. 调整配置，强制Pillow重新编译 #

修改你的01_packages.config文件，确保系统依赖安装完成后，重新从源码编译Pillow：

packages:
  yum:
    git: []
    postgresql93-devel: []
    libjpeg-turbo-devel: []
    freetype-devel: []
    libpng-devel: []  # 补充这个依赖，确保Pillow有完整的图形库支持
commands:
  setuptools:
    command: /opt/python/run/venv/bin/pip install setuptools --upgrade
  uninstall_pillow:
    command: /opt/python/run/venv/bin/pip uninstall -y Pillow
    ignoreErrors: true  # 即使Pillow未安装也不中断部署
  reinstall_pillow:
    command: /opt/python/run/venv/bin/pip install Pillow==8.4.0 --no-cache-dir

这个配置的执行逻辑是：

• 先安装所有必要的系统依赖（包括freetype和png的开发库）
• 升级setuptools确保编译环境正常
• 卸载已有的Pillow（避免缓存干扰）
• 从源码重新编译安装Pillow，此时会自动链接系统中的freetype库，生成_imagingft模块

2. 备选方案：修改requirements.txt强制编译参数 #

如果上面的配置仍未解决问题，可以在requirements.txt中给Pillow添加编译参数，明确启用freetype支持：

Pillow==8.4.0 --global-option="build_ext" --global-option="--enable-freetype"

注意：这种方法需要配合01_packages.config中的yum依赖配置使用，确保系统已经安装了freetype-devel。

3. 验证部署结果 #

部署完成后，你可以通过SSH连接到Elastic Beanstalk实例，执行以下命令验证：

# 进入虚拟环境
source /opt/python/run/venv/bin/activate
# 测试Pillow的ImageFont模块
python -c "from PIL import ImageFont; print('ImageFont loaded successfully')"

如果没有报错，说明_imagingft模块已经正常安装。

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