基于Alpine的Docker Django镜像安装mysqlclient库报错如何解决？

mysqlclient安装时依赖系统层面的MySQL客户端开发库与编译工具链，Alpine轻量镜像默认未预装这些组件，因此找不到编译所需的mysql_config工具，触发安装失败。

修改你的Django项目Dockerfile，在安装Python依赖前先安装所需的系统依赖，示例修改后的完整Dockerfile如下：

# Base image for newly image. Alpine version is lightweigther.
FROM python:3.9-alpine
ENV PYTHONUNBUFFERED 1

# Set app directory
WORKDIR /app
COPY . /app/

# 安装系统依赖：编译工具 + MySQL客户端开发库
RUN apk add --no-cache --virtual .build-deps gcc musl-dev mariadb-dev \
    && python -m pip install --upgrade pip \
    # 安装Python依赖
    && python -m pip install Django djangorestframework django-extensions mysqlclient python-dotenv \
    # 卸载编译用的临时依赖，减小镜像体积
    && apk del .build-deps \
    # 保留运行时所需的MySQL客户端库
    && apk add --no-cache mariadb-connector-c

如果不想处理编译依赖，也可以用纯Python实现的pymysql替代mysqlclient，操作如下：

• 将Dockerfile中安装mysqlclient的行替换为python -m pip install pymysql
• 在Django项目的__init__.py中添加如下代码即可兼容Django的MySQL驱动调用：

import pymysql
pymysql.install_as_MySQLdb()

内容的提问来源于stack exchange，提问作者Renan Ferreira