Docker Alpine构建安装mysqlclient失败：找不到有效pkg-config名称

问题原因 #

Alpine Linux里，mariadb-connector-c-dev提供的pkg-config配置名称是mariadb，但mysqlclient默认查找的是mysql或mysqlclient，就算装了pkgconfig，不指定正确的配置路径或环境变量，还是会触发Can not find valid pkg-config name错误。

修正方案 #

方案一：设置PKG_CONFIG_PATH环境变量 #

修改Dockerfile，指定pkgconfig的搜索路径，让mysqlclient能找到mariadb的配置文件：

FROM python:3.11-alpine
WORKDIR /usr/src/app
COPY requirements.txt .
RUN apk add --no-cache gcc musl-dev mariadb-connector-c-dev pkgconfig && \
    export PKG_CONFIG_PATH=/usr/lib/pkgconfig:/usr/share/pkgconfig && \
    pip install --no-cache-dir -r requirements.txt
COPY . .
CMD ["python", "manage.py", "runserver", "0.0.0.0:8000"]

方案二：直接指定mysql_config路径 #

Alpine中mariadb的mysql_config工具位于/usr/bin/mariadb_config，通过环境变量告诉mysqlclient使用这个路径：

FROM python:3.11-alpine
WORKDIR /usr/src/app
COPY requirements.txt .
RUN apk add --no-cache gcc musl-dev mariadb-connector-c-dev pkgconfig && \
    export MYSQL_CONFIG=/usr/bin/mariadb_config && \
    pip install --no-cache-dir -r requirements.txt
COPY . .
CMD ["python", "manage.py", "runserver", "0.0.0.0:8000"]

优化镜像体积（可选） #

安装完依赖后，可以删除gcc、musl-dev这些临时编译工具，大幅减小镜像大小：

FROM python:3.11-alpine
WORKDIR /usr/src/app
COPY requirements.txt .
# 用虚拟包组管理编译依赖，安装完成后一键删除
RUN apk add --no-cache --virtual .build-deps gcc musl-dev mariadb-connector-c-dev pkgconfig && \
    export MYSQL_CONFIG=/usr/bin/mariadb_config && \
    pip install --no-cache-dir -r requirements.txt && \
    apk del .build-deps
COPY . .
CMD ["python", "manage.py", "runserver", "0.0.0.0:8000"]

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