优先选PyMySQL，因其纯Python实现、安装快、兼容性好、调试方便；mysql-connector-python仅在需Oracle官方特定功能（如Kerberos认证）时选用。
用 pymysql 还是 mysql-connector-python？
直接选 pymysql，除非你明确需要 Oracle 官方驱动的特定功能（比如 Kerberos 认证）。pymysql 纯 Python 实现，安装快、兼容性好、调试方便，绝大多数项目够用。而 mysql-connector-python 有时会因 C 扩展或版本错配导致 ImportError: DLL load failed 或 AttributeError: 'MySQLConnection' object has no attribute 'encoding'。
- 安装命令统一用：
pip install pymysql - 连接字符串写法一致，可无缝切换驱动
- Django/Flask 默认推荐
pymysql，只需在入口加两行模拟 MySQLdb：import pymysql<br>pymysql.install_as_MySQLdb()
连接时常见报错和对应修复
连不上不是密码错就是网络或权限没配对。先看错误信息里有没有 Access denied、Can't connect to MySQL server 或 Unknown database —— 每个都指向不同环节。
-
Access denied for user 'xxx'@'xxx'：检查 MySQL 用户是否允许从应用所在主机连接（CREATE USER 'user'@'%' IDENTIFIED BY 'pwd';），别只建了@'localhost' -
Can't connect to MySQL server on 'xxx' (110)：确认 MySQL 是否监听非127.0.0.1（查bind-address配置），防火墙是否放行 3306 端口，Docker 容器是否用了-p 3306:3306并暴露正确端口 -
Unknown database 'xxx'：不是连接失败，是库不存在。先手动mysql -u root -p -e "CREATE DATABASE IF NOT EXISTS xxx CHARACTER SET utf8mb4;"
connect() 参数怎么填才不踩坑
别全靠默认值。尤其 charset 和 autocommit 不设好，中文乱码或事务回滚失效是高频问题。
- 必须显式指定
charset='utf8mb4'，否则 emoji 和四字节 UTF-8 字符写入失败或变成??? - Web 应用建议设
autocommit=False，自己控制commit()/rollback()；脚本类工具可设autocommit=True简化逻辑 - 加
cursorclass=pymysql.cursors.DictCursor，让fetchall()返回字典而非元组，字段名不用再手动映射 - 超时参数别省：
connect_timeout=10、read_timeout=30、write_timeout=30，避免慢查询拖死整个服务
连接池要不要自己写？
别手写。用 DBUtils 的 PooledDB 就够，SQLAlchemy 自带连接池更省心。自己维护连接数、回收逻辑容易漏异常处理，反而引发连接泄漏。
立即学习“Python免费学习笔记（深入）”；
- 轻量级项目用
DBUtils：from dbutils.pooled_db import PooledDB<br>pool = PooledDB(pymysql, maxconnections=5, host='127.0.0.1', user='root', ...)</br>conn = pool.connection()
- 已有 ORM（如 SQLAlchemy）就直接配置
pool_size和max_overflow，它底层已封装好连接复用与超时清理 - 注意：Flask-SQLAlchemy 的
SQLALCHEMY_ENGINE_OPTIONS必须传 dict，不能直接写参数，否则池子不生效
真正麻烦的从来不是“连上”，而是连接什么时候关、异常时有没有回滚、长连接会不会被 MySQL 的 wait_timeout 中断。这些细节比选哪个驱动重要得多。
