使用pip安装MariaDB报错：需升级MariaDB Connector/C至3.3.1及以上

当前系统的MariaDB Connector/C版本（3.1.18）低于Python包要求的3.3.1，以下是不同系统的升级方案：

Debian/Ubuntu 系列 #

• 移除旧版本相关依赖包：

  sudo apt remove --purge libmariadb-dev libmariadb3 mariadb-common
  

• 添加MariaDB官方软件源（国内镜像加速）：
  先导入签名密钥：

  sudo apt-key adv --fetch-keys 'https://mariadb.org/mariadb_release_signing_key.asc'
  

  创建源配置文件：

  sudo tee /etc/apt/sources.list.d/mariadb.list <<EOF
  deb [arch=amd64,arm64,ppc64el] https://mirrors.tuna.tsinghua.edu.cn/mariadb/repo/10.11/ubuntu $(lsb_release -cs) main
  EOF
  

• 更新源并安装新版本连接器：

  sudo apt update
  sudo apt install libmariadb-dev libmariadb3
  

• 重新尝试安装Python的mariadb包：

  pip install mariadb
  

RedHat/CentOS 系列 #

• 移除旧版本依赖包：

  sudo yum remove mariadb-connector-c-devel mariadb-connector-c
  

• 添加MariaDB官方软件源：

  sudo tee /etc/yum.repos.d/mariadb.repo <<EOF
  [mariadb]
  name = MariaDB
  baseurl = https://mirrors.tuna.tsinghua.edu.cn/mariadb/yum/10.11/centos\$releasever-amd64
  gpgkey=https://mariadb.org/mariadb_release_signing_key.asc
  gpgcheck=1
  EOF
  

• 安装新版本连接器：

  sudo yum install mariadb-connector-c-devel mariadb-connector-c
  

• 重新安装Python的mariadb包：

  pip install mariadb
  

手动编译安装（通用方案） #

如果官方源无法适配你的系统，可手动编译源码安装：

• 下载MariaDB Connector/C 3.3.1及以上版本的源码压缩包，解压后进入目录：

  tar -zxvf mariadb-connector-c-*.tar.gz
  cd mariadb-connector-c-*
  

• 配置编译参数（指定安装路径）：

  cmake . -DCMAKE_INSTALL_PREFIX=/usr/local/mariadb-connector
  

• 编译并安装：

  make
  sudo make install
  

• 设置环境变量，让pip能识别到新安装的连接器：

  export LD_LIBRARY_PATH=/usr/local/mariadb-connector/lib:$LD_LIBRARY_PATH
  export CPATH=/usr/local/mariadb-connector/include:$CPATH
  

• 重新安装Python的mariadb包：

  pip install mariadb
  

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