Python连接MySQL：PyMySQL与SQLAlchemy使用教程

本文深入解析了Python连接MySQL的两大主流方案——PyMySQL与SQLAlchemy的协同使用要点，直击开发者常踩的三大坑：连接字符串中驱动名必须严格写为`pymysql`（而非`mysql`或拼写错误的`pymsql`），否则将触发模块找不到或方言识别失败；务必启用`pool_pre_ping=True`以主动检测连接有效性，避免因空闲断连导致查询中途崩溃；以及中文乱码问题的本质不在代码而在全链路字符集配置——从连接字符串添加`?charset=utf8mb4`，到MySQL服务端`my.cnf`的全局设置，再到表与字段的字符集转换，缺一不可。这些看似细节的配置，恰恰是生产环境稳定运行的关键防线。

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。

• 加 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

最常被跳过的其实是服务端字符集配置——连得通、写得进、查出来是乱码，八成卡在这儿。

今天关于《Python连接MySQL：PyMySQL与SQLAlchemy使用教程》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！