Flask 里操作 MySQL，PyMySQL
和 mysqlclient
哪个更稳？
直接结论：
mysqlclient是当前 Flask 生态中最成熟、性能更好、兼容性更强的选择。它底层调用 MySQL C API，比纯 Python 实现的
PyMySQL更快，尤其在批量读写和连接复用场景下差异明显。
常见错误现象：用
PyMySQL配合
SQLAlchemy时，遇到
OperationalError: (2013, 'Lost connection to MySQL server during query')，尤其在长连接或空闲超时后——这往往不是代码问题，而是
PyMySQL对连接池和超时重试的处理不如
mysqlclient健壮。
mysqlclient要求系统安装
mysql-config（Linux/macOS）或预编译 wheel（Windows），安装时可能报
mysql.h not found，需先装
libmysqlclient-dev（Ubuntu）或
mysql-client（macOS via Homebrew）
PyMySQL零依赖，
pip install PyMySQL即装即用，适合快速原型或容器环境受限场景 两者在 SQLAlchemy 的 URL 写法一致：
mysql://user:pass@host/db或显式指定驱动：
mysql+mysqldb://...（
mysqlclient） /
mysql+pymysql://...
SQLAlchemy + Flask 的最小可靠配置，绕开常见坑
不用
Flask-SQLAlchemy扩展也能干净集成，反而更容易控制连接行为。关键是正确设置
pool_pre_ping和
pool_recycle，否则线上容易出现“连接已断但 SQLAlchemy 不知道”的静默失败。
from sqlalchemy import create_engine from sqlalchemy.orm import scoped_session, sessionmaker <p>engine = create_engine( "mysql+mysqldb://user:pass@localhost/mydb", pool_pre_ping=True, # 每次取连接前发一个 SELECT 1 检查是否存活 pool_recycle=3600, # 强制 1 小时后回收连接（避免 MySQL wait_timeout 干扰） pool_size=10, max_overflow=20, echo=False # 上线务必关掉 )</p><p>db_session = scoped_session(sessionmaker(bind=engine))
注意：
pool_pre_ping=True会轻微增加延迟，但它比靠
try/except捕获连接异常再重试更主动、更可控；
pool_recycle值必须小于 MySQL 服务端的
wait_timeout（默认 28800 秒），否则连接会被服务端单方面断开。
为什么别碰 _mysql
这个模块？
_mysql是
mysqlclient的底层 C 模块，不对外暴露完整接口，也不提供连接池、游标管理等应用层能力。直接导入并使用它，等于放弃所有 ORM 和连接抽象，回到手写
connect()/query()/fetch()的原始阶段，且极易写出资源泄漏代码。
典型误用：
import _mysql
db = _mysql.connect(host="localhost", user="root", passwd="", db="test")
db.query("SELECT * FROM users") # 没有自动关闭、没有参数化、没有异常传播机制
它不支持参数化查询（易 SQL 注入），也没有 with上下文管理 无法与 Flask 的请求生命周期绑定（比如
@app.teardown_appcontext清理） 一旦出错，连接对象可能卡死，后续请求全挂
真正轻量 ≠ 用最底层模块，而是在保证健壮前提下减少抽象层级——
mysqlclient+ 原生
SQLAlchemy就是这个平衡点。
本地开发 vs Docker 部署时的驱动选择差异
开发机上装
mysqlclient失败很常见（尤其是 macOS M1/M2 或 Windows WSL），这时可以临时切到
PyMySQL，但必须同步调整配置，否则行为不一致： Docker 中推荐固定用
mysqlclient：在
Dockerfile里加
RUN apt-get install -y default-libmysqlclient-dev，再
pip install mysqlclient若坚持用
PyMySQL，需显式禁用 prepared statement（MySQL 8.0+ 默认开启，
PyMySQL支持不完善）：
mysql+pymysql://...?use_unicode=1&charset=utf8mb4&autocommit=true&cursorclass=pymysql.cursors.DictCursor环境变量区分驱动：
SQLALCHEMY_DATABASE_URI在 .env 里设不同值，而不是硬编码在代码中
最常被忽略的是字符集：无论用哪个驱动，都必须显式指定
charset=utf8mb4，否则 emoji 和部分中文会存成
???，且这个参数位置因驱动而异——
mysqlclient通过 URL 查询参数传，
PyMySQL则要进
connect_args字典。
