安装Flask MySQL连接器遇错：执行pip3 install flask_mysqldb报错求助

这个报错本质是系统缺少MySQL开发依赖包——flask_mysqldb 依赖的 mysqlclient 需要MySQL的头文件和库文件才能编译安装，下面按不同系统给出解决步骤：

Debian/Ubuntu 系列 Linux #

• 先安装系统层面的依赖：

  sudo apt-get update
  sudo apt-get install python3-dev default-libmysqlclient-dev build-essential
  

• 再执行安装命令：

  pip3 install flask_mysqldb
  

RHEL/CentOS/Fedora 系列 Linux #

• 安装系统依赖：

  sudo yum install python3-devel mysql-devel gcc
  

• 重新运行安装：

  pip3 install flask_mysqldb
  

macOS #

• 用Homebrew装MySQL开发库：

  brew install mysql-client
  

• 临时配置环境变量让pip找到依赖：

  export PATH="/usr/local/opt/mysql-client/bin:$PATH"
  export LDFLAGS="-L/usr/local/opt/mysql-client/lib"
  export CPPFLAGS="-I/usr/local/opt/mysql-client/include"
  

• 最后执行安装：

  pip3 install flask_mysqldb
  

Windows #

• 直接装预编译的mysqlclient wheel包，绕开编译环节：
  1. 去PyPI的mysqlclient页面下载对应你Python版本、系统位数的.whl文件（比如Python3.10+64位就找带cp310-win_amd64的文件）
  2. 用pip安装下载好的包：

     pip3 install 你的文件路径/mysqlclient-xxx.whl
     

  3. 再安装flask_mysqldb：

     pip3 install flask_mysqldb
     

替代方案 #

如果还是搞不定，换用pymysql+flask-sqlalchemy组合也能实现Flask连接MySQL：

• 安装依赖：

  pip3 install pymysql flask-sqlalchemy
  

• 应用里的配置示例：

  from flask import Flask
  from flask_sqlalchemy import SQLAlchemy
  
  app = Flask(__name__)
  # 替换成你的数据库账号、密码和库名
  app.config['SQLALCHEMY_DATABASE_URI'] = 'mysql+pymysql://root:123456@localhost/your_db'
  db = SQLAlchemy(app)
  

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