安装mysqlclient时报Command errored out with exit status 1错误如何解决

报错根因 #

mysqlclient是需要本地编译的Python包，编译过程依赖系统提供的mysql_config工具读取MySQL编译参数，该工具包含在MySQL开发依赖包中，系统未安装该依赖包就会触发该报错。

各系统解决方案 #

• Debian/Ubuntu 系列（适配你当前使用的Python2.7环境）
  先执行系统依赖安装命令：

  sudo apt-get update && sudo apt-get install -y libmysqlclient-dev python-dev
  

  依赖安装完成后重新安装mysqlclient：

  pip install mysqlclient
  

• RHEL/CentOS 7及更早版本
  先安装系统依赖：

  sudo yum install -y mysql-devel python-devel
  

  再重新安装mysqlclient：

  pip install mysqlclient
  

• CentOS 8+/Fedora 系列
  先安装系统依赖：

  sudo dnf install -y mysql-devel python2-devel
  

  再重新安装mysqlclient：

  pip install mysqlclient
  

• macOS 环境
  先通过Homebrew安装MySQL依赖：

  brew install mysql
  

  再重新安装mysqlclient：

  pip install mysqlclient
  

特殊场景处理 #

如果已经安装过MySQL服务但仍报错，大概率是mysql_config未加入系统环境变量：

1. 执行查找命令定位文件路径：sudo find / -name mysql_config
2. 假设查找结果为/usr/local/mysql/bin/mysql_config，执行命令将路径加入环境变量：

   export PATH=$PATH:/usr/local/mysql/bin
   

3. 重新执行mysqlclient安装命令即可。

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