PyMySQL需用mysql+pymysql://连接字符串,驱动名严格为pymysql;启用pool_pre_ping=True检测连接有效性;中文需连接字符串加?charset=utf8mb4并配置MySQL服务端及表字符集。

PyMySQL 是纯 Python 实现的 MySQL 客户端,SQLAlchemy 默认不直接支持它——但能用,关键在连接字符串写法和驱动名别名。
PyMySQL 连接字符串里必须写 pymysql,不能写 mysql 或 mysqldb
SQLAlchemy 通过方言(dialect)识别后端,mysql:// 默认走 MySQLdb(已废弃),要强制用 PyMySQL,得显式声明驱动:
- ✅ 正确:
mysql+pymysql://user:pass@localhost/dbname - ❌ 错误:
mysql://user:pass@localhost/dbname(报错ModuleNotFoundError: No module named 'MySQLdb') - ❌ 错误:
mysql+pymsql://...(拼写错误,驱动名不匹配,报sqlalchemy.exc.NoSuchModuleError)
驱动名是硬编码在 SQLAlchemy 的 sqlalchemy.dialects.mysql 里的,pymysql 是唯一合法标识。
SQLAlchemy 创建引擎时加 pool_pre_ping=True 防连接失效
PyMySQL 默认不检测连接是否还活着,长时间空闲后首次查询可能抛 OperationalError: (2013, 'Lost connection to MySQL server during query')。这不是代码写错了,是连接池复用了断开的 socket。
立即学习“Python免费学习笔记(深入)”;
- 加
pool_pre_ping=True让 SQLAlchemy 每次取连接前发个SELECT 1探活 - 代价是每次获取连接多一次往返,但比查到一半崩掉更可控
- 别只靠
pool_recycle=3600:它只重置连接年龄,不验证连通性
示例:create_engine("mysql+pymysql://...", pool_pre_ping=True)
PyMySQL 在 Windows 上中文乱码?检查 charset=utf8mb4 和 MySQL 服务端配置
PyMySQL 默认不设字符集,SQLAlchemy 也不自动传 charset 参数,容易导致插入中文变 ??? 或报 Incorrect string value。
- 连接字符串末尾加上
?charset=utf8mb4:mysql+pymysql://...?charset=utf8mb4 - 确保 MySQL 服务端
my.cnf里有:collation-server = utf8mb4_unicode_ci和character-set-server = utf8mb4 - 表和字段也得是
utf8mb4,光连上没用:ALTER TABLE t CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci
最常被跳过的其实是服务端字符集配置——连得通、写得进、查出来是乱码,八成卡在这儿。











