Docker部署Django应用报错：找不到ft2build.h

问题背景 #

运行docker build -t sometag .时出现元数据生成失败错误，核心报错信息为：

!!!!! cannot find ft2build.h

当前Dockerfile中已执行的命令：

RUN apk update && apk add --no-cache gcc musl-dev postgresql-dev python3-dev libffi-dev && pip install --upgrade pip

requirements.txt包含reportlab==3.6.9、Pillow==9.1.0、xhtml2pdf==0.2.7等依赖包。

解决方案 #

错误确实源于Dockerfile缺少必要的系统依赖包，ft2build.h是FreeType库的头文件，而reportlab（以及依赖它的xhtml2pdf）需要FreeType和libart库完成编译，Pillow也需要图片处理相关依赖支持。修改你的RUN命令，补充以下依赖：

RUN apk update && apk add --no-cache \
    gcc musl-dev postgresql-dev python3-dev libffi-dev \
    freetype-dev libjpeg-turbo-dev libpng-dev libart-lgpl-dev \
    && pip install --upgrade pip

各依赖作用说明 #

• freetype-dev：提供缺失的ft2build.h头文件，解决核心报错
• libjpeg-turbo-dev、libpng-dev：满足Pillow编译图片处理模块的需求
• libart-lgpl-dev：支持reportlab编译_renderPM扩展模块

镜像体积优化（可选） #

为减小最终镜像大小，可在安装完成后清理apk缓存：

RUN apk update && apk add --no-cache \
    gcc musl-dev postgresql-dev python3-dev libffi-dev \
    freetype-dev libjpeg-turbo-dev libpng-dev libart-lgpl-dev \
    && pip install --upgrade pip \
    && rm -rf /var/cache/apk/*

内容的提问来源于stack exchange，提问作者Carlos S. C.