Ubuntu 24.04下Python 3.12.3无法安装mariadb模块的求助

方法一：使用Python虚拟环境（推荐，不破坏系统环境） #

• 安装虚拟环境工具：

  sudo apt install python3-venv
  

• 创建并激活虚拟环境（以项目目录my_project为例）：

  mkdir my_project && cd my_project
  python3 -m venv venv
  source venv/bin/activate
  

• 激活环境后直接用pip安装mariadb模块：

  pip install mariadb
  

• 后续运行代码时，先激活虚拟环境再执行即可。

方法二：安装编译依赖后用pip强制安装（谨慎使用） #

Ubuntu 24.04官方源暂未提供适配Python3.12的python3-mariadb包，可先安装编译依赖，再绕过系统包管理限制安装：

• 安装编译所需依赖：

  sudo apt install libmariadb-dev gcc python3-dev
  

• 用pip安装并添加参数绕过限制：

  pip3 install mariadb --break-system-packages
  

注意：该参数会绕过系统的包管理校验，可能引发系统Python依赖冲突，仅在明确风险的情况下使用。

方法三：添加MariaDB官方源获取适配包 #

若偏好通过系统包管理器安装，可添加MariaDB官方源获取对应版本的Python绑定包：

• 添加MariaDB官方GPG密钥：

  sudo apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 0xF1656F24C74CD1D8
  

• 添加适配Ubuntu 24.04（代码名noble）的MariaDB 10.11分支源：

  sudo add-apt-repository 'deb [arch=amd64,arm64,ppc64el] http://mirror.mariadb.org/repo/10.11/ubuntu noble main'
  

• 更新源并安装python3-mariadb：

  sudo apt update
  sudo apt install python3-mariadb
  

注意：第三方源可能带来版本兼容问题，你的MariaDB版本为10.11.7，与上述源分支匹配，可正常安装。

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