Django 使用 Docker 安装 Pillow 报错问题解决方法

在本文中，我们将介绍如何在使用 Docker 构建 Django 项目时解决安装 Pillow 库的报错问题。Pillow 是一个强大的图像处理库，广泛应用于 Django 项目中，然而在使用 Alpine Linux 作为基础镜像同时安装 Django、Docker 和 Python 时，安装 Pillow 可能会出现一些困难。

阅读更多：Django 教程

问题描述

在使用 Docker 构建 Django 项目时，我们常常使用python-alpine作为基础镜像，因为它体积小巧且快速。然而，在尝试安装 Pillow 库时，我们可能会遇到以下报错信息：

ERROR: Command errored out with exit status 1:
   ...

`jpeglib.h`、`zlib.h` 或 `libpng-dev`

如上所示，当我们在python-alpine镜像中尝试安装 Pillow 时，它会提示我们缺少一些依赖库，包括jpeglib.h、zlib.h和libpng-dev。这是因为python-alpine镜像是基于 Alpine Linux 构建的，并使用了类似于 apk 工具的包管理器。

解决方法

要解决这个问题，我们需要在 Dockerfile 中添加一些额外的命令，以安装这些缺少的依赖库。以下是我们可以采取的方法：

方法一：使用 apk 安装依赖库

在 Dockerfile 中添加以下命令以安装缺少的依赖库：

RUN apk add --no-cache jpeg-dev zlib-dev libjpeg

这个命令将使用 apk 包管理器安装缺少的依赖库。--no-cache参数可以减小镜像体积，并避免在构建过程中产生缓存文件。

完整的 Dockerfile 示例代码如下所示：

FROM python:3.9-alpine

RUN apk add --no-cache jpeg-dev zlib-dev libjpeg

WORKDIR /code

COPY requirements.txt .
RUN pip install -r requirements.txt

COPY . .
CMD ["python", "manage.py", "runserver"]

方法二：使用 apk 安装具体版本的依赖库

在有些情况下，使用最新版本的依赖库可能会导致与 Pillow 不兼容的问题。为了解决这个问题，我们可以使用具体版本的依赖库。首先，我们需要找到特定版本的依赖库。例如，我们可以使用以下命令查询可用的jpeg-dev版本：

apk search --no-cache jpeg-dev

然后，在 Dockerfile 中添加以下命令以安装特定版本的依赖库：

RUN apk add --no-cache jpeg-dev=8-r2 zlib-dev libjpeg

这个命令将安装特定版本的jpeg-dev依赖库，如8-r2所示。通过指定特定版本，我们可以避免与 Pillow 不兼容的问题。

完整的 Dockerfile 示例代码如下所示：

FROM python:3.9-alpine

RUN apk add --no-cache jpeg-dev=8-r2 zlib-dev libjpeg

WORKDIR /code

COPY requirements.txt .
RUN pip install -r requirements.txt

COPY . .
CMD ["python", "manage.py", "runserver"]