Docker部署Python项目遇subprocess-exited-with-error：reportlab编译失败

问题原因 #

• 你没在requirements.txt里直接声明reportlab，但xhtml2pdf依赖它，pip会自动拉取满足版本要求的reportlab
• ft2build.h是FreeType字体库的头文件，Alpine Linux镜像默认没有安装这个库的开发包，导致编译reportlab时失败

解决方案 #

修改你的Dockerfile，补充必要的系统依赖，并优化镜像体积：

FROM python:3.10.6-alpine
ENV PYTHONUNBUFFERED 1
WORKDIR /demo_project

COPY ./requirements.txt ./requirements.txt

# 安装编译依赖+Python依赖，之后清理无用文件减小镜像
RUN apk add --no-cache gcc python3-dev jpeg-dev zlib-dev gpgme-dev libc-dev musl-dev g++ freetype-dev libpng-dev \
    && pip install --upgrade pip wheel setuptools \
    && pip install -r requirements.txt \
    # 删除编译用的系统依赖和pip缓存
    && apk del gcc python3-dev jpeg-dev zlib-dev gpgme-dev libc-dev musl-dev g++ freetype-dev libpng-dev \
    && rm -rf /root/.cache/pip

COPY ./demo_project /demo_project

关键修改点说明 #

• 添加freetype-dev：直接提供编译reportlab需要的ft2build.h头文件，解决核心报错
• 添加libpng-dev：reportlab处理图片时依赖的库，提前安装避免后续潜在错误
• 合并RUN命令+清理依赖：把多个RUN步骤合并成一个，减少镜像层数；安装完Python依赖后删除编译用的系统库和pip缓存，大幅减小最终镜像的体积

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