Python配置MySQL数据库驱动：MySQLdb与PyMySQL安装教程

本文详解了Python连接MySQL数据库的驱动选型与配置实践，重点指出MySQLdb已不再支持Python 3.8+，强烈建议全面转向PyMySQL或mysql-connector-python；文章不仅剖析了MySQLdb编译失败的根本原因（C扩展停更、依赖缺失），还提供了PyMySQL安装避坑指南、Django兼容配置的关键代码（pymysql.install_as_MySQLdb()必须前置）、以及两种主流驱动在开发调试、生产部署和字符集处理等方面的实用对比——帮你避开90%的数据库连接踩坑场景，轻松实现平滑迁移与稳定运行。

MySQLdb 在 Python 3.8+ 上根本装不上，别硬试

不是你 pip 没更新、不是源没换对，是 MySQLdb 依赖的 C 扩展早就不维护了，官方明确不支持 Python 3.8 及以后版本。强行用 pip install MySQLdb 会卡在编译阶段，报一堆 mysql_config not found 或 fatal error: my_config.h: No such file。Mac 上还可能触发 Xcode 命令行工具缺失提示，Linux 则大概率缺 libmysqlclient-dev —— 这些都是治标不治本的信号。

实操建议：

• 直接放弃 MySQLdb，它已成历史遗留组件，连 PyPI 页面都标注了 Deprecated
• 所有新项目、升级项目，统一用 PyMySQL（纯 Python 实现）或 mysql-connector-python（Oracle 官方驱动）
• 如果老代码里写了 import MySQLdb，改一行就能切过去：import pymysql as MySQLdb，绝大多数 API 是兼容的

PyMySQL 安装失败常见原因和解法

PyMySQL 本身没编译环节，但安装失败往往不是它的问题，而是环境干扰。最典型的是 pip 版本太低、虚拟环境没激活、或者系统里混了 conda 和 pip 的包管理。

常见错误现象：

• ERROR: Could not find a version that satisfies the requirement PyMySQL → pip 太旧，运行 python -m pip install --upgrade pip
• 装完 import 报 ModuleNotFoundError: No module named 'pymysql' → 检查当前 Python 解释器路径：which python 和 python -c "import sys; print(sys.executable)" 是否一致
• 在 PyCharm 里装了却标红 → 看右下角 Python 解释器是否选对，别用系统 Python 配了 venv 却没选中

推荐安装命令：pip install PyMySQL（不用加 --user，除非你确定要全局装）

Django 里怎么配 PyMySQL 而不是 MySQLdb

Django 默认尝试导入 MySQLdb，所以即使你装了 PyMySQL，启动时仍会报 ImportError: No module named MySQLdb。这不是 Django 的 bug，是它的加载逻辑决定的。

必须在 Django 项目入口（通常是 manage.py 或 settings.py 顶部）插入兼容层：

import pymysql
pymysql.install_as_MySQLdb()

这行代码的作用是把 PyMySQL 注册成 MySQLdb 的替代品，后续所有 import MySQLdb 都会被重定向到 PyMySQL。注意顺序：必须在 django.setup() 或任何 Django 模块导入前执行。

容易踩的坑：

• 写在 settings.py 中间或底部 → 失效，Django 已经开始加载数据库模块了
• 只在本地开发环境加，忘了部署服务器 → 上线就崩
• 用了 Gunicorn/uWSGI，但只在 manage.py 加了 → 要同步加到 WSGI 入口文件（如 myproject/wsgi.py）

PyMySQL 和 mysql-connector-python 怎么选

两者都能跑通，但行为细节差得挺多。比如连接超时、字符集处理、SSL 支持，默认值都不一样。

使用场景对比：

• 需要快速验证、调试、写脚本 → 用 PyMySQL，安装快、报错信息直白、支持 autocommit=True 开箱即用
• 生产环境、要求 Oracle 官方支持、用到企业级特性（如 FIDO 认证、X Protocol）→ 选 mysql-connector-python，但要注意它默认关闭 autocommit，不显式 commit() 就会丢数据
• Django 用户 → 优先 PyMySQL + pymysql.install_as_MySQLdb()，生态适配最稳

性能上差别不大，但 PyMySQL 是纯 Python，高并发下 CPU 占用略高；mysql-connector-python 有 C 扩展可选，但默认安装没开。

真正容易被忽略的是字符集配置。哪怕数据库、表都设了 utf8mb4，PyMySQL 默认连接参数还是 latin1。必须显式传参：charset='utf8mb4'，否则存 emoji 或生僻字会变 ?。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Python配置MySQL数据库驱动：MySQLdb与PyMySQL安装教程》文章吧，也可关注golang学习网公众号了解相关技术文章。