Python Docker构建安装PIP包时出现mysqlclient编译错误如何解决？

报错核心为低版本mysqlclient（1.3.7）与系统内置的MariaDB客户端开发包不兼容：MariaDB 10.2及以上版本移除了MYSQL结构体中的reconnect成员，而你要安装的mysqlclient 1.3.7仍在调用该属性，因此编译阶段直接报错，该问题和GCC是否安装无关。

以下方案均适配Docker构建场景，按需选择即可：

• 方案1：升级mysqlclient到兼容版本
  如果你的项目兼容更高版本的mysqlclient，直接将requirements.txt中mysqlclient==1.3.7修改为mysqlclient==1.4.6即可，这是最后一个支持Python2.7的mysqlclient版本，已经完成了新版MariaDB的结构适配。
• 方案2：不修改依赖版本，安装兼容旧API的系统依赖
  若项目不能调整mysqlclient版本，可在Dockerfile的pip install步骤之前，先安装兼容旧版MySQL API的依赖包，以Debian/Ubuntu系基础镜像为例：

  RUN apt-get update && apt-get install -y --no-install-recommends libmariadb-dev-compat libmysqlclient-dev gcc python2.7-dev
  

• 方案3：临时添加编译参数绕过报错
  不需要调整依赖也不需要修改系统依赖，直接在执行pip安装时添加编译参数即可：

  RUN CFLAGS="-D__MYSQL_NO_RECONNECT__" pip install -r requirements.txt
  

日志提示当前pip版本过低，你可以在安装依赖前先升级pip到Python2.7支持的最高版本，避免后续安装其他包出现兼容性问题：

RUN /usr/local/bin/python -m pip install --upgrade pip==20.3.4

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