当 MySQL Connector/Python 无法连接本地数据库而 PyMySQL 可以正常工作时，问题通常源于其默认启用的 C 扩展（libmysqlclient）在当前环境（如 Python 3.12+、Windows 或精简版 MySQL 安装）中缺失或不兼容；启用纯 Python 模式（use_pure=True）可快速绕过该限制。
当 mysql connector/python 无法连接本地数据库而 pymysql 可以正常工作时，问题通常源于其默认启用的 c 扩展（libmysqlclient）在当前环境（如 python 3.12+、windows 或精简版 mysql 安装）中缺失或不兼容；启用纯 python 模式（`use_pure=true`）可快速绕过该限制。
在 Python 中使用 mysql.connector 连接 MySQL 8.0+ 数据库时，即使配置正确（主机、用户、密码无误，服务运行正常，权限已授予），仍可能静默失败或抛出模糊异常（如 ConnectionError、InterfaceError 或直接卡住）。这与 PyMySQL 的稳定表现形成鲜明对比——根本原因在于 MySQL Connector/Python 的双模式架构：它默认优先加载编译型 C 扩展（基于 libmysqlclient）以提升性能；但该扩展对底层依赖极为敏感，在现代 Python 环境（尤其是 Python ≥3.12）、Windows 平台或未完整安装 MySQL Client 开发包的系统中极易失效。
✅ 推荐解决方案：启用纯 Python 模式
只需在 connect() 调用中显式添加 use_pure=True 参数，强制使用纯 Python 实现（完全兼容、零本地依赖）：
import mysql.connector
from mysql.connector import Error
try:
print("Attempting connection with pure Python mode...")
mydb = mysql.connector.connect(
host="127.0.0.1",
user="root",
password="s12345678",
database="", # 可选：指定初始数据库
use_pure=True # ? 关键修复参数
)
if mydb.is_connected():
print("✅ MySQL Connector connected successfully (pure Python mode)")
print(f"Server version: {mydb.get_server_info()}")
mydb.close()
except Error as e:
print(f"❌ Connection failed: {e}")✅ 优势：无需安装额外系统库、兼容所有平台、适配 Python 3.12+、调试友好；性能损耗在绝大多数应用中可忽略（实测 QPS 下降
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac下载让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
⚠️ 注意事项与补充建议
-
不要跳过
database参数验证：若连接后执行查询报Database not selected，请确保在connect()中指定database="your_db"，或连接后调用mydb.database = "your_db"。 -
认证插件兼容性：MySQL 8.0 默认使用
caching_sha2_password，而旧版 Connector 可能不支持。你已正确执行ALTER USER ... IDENTIFIED WITH mysql_native_password，这是必要前提。 -
避免混用驱动：
PyMySQL和mysql.connector是独立实现，连接字符串参数不完全互通（如charsetvscollation），切换时需检查文档。 -
C 扩展方案（进阶）：若坚持使用 C 模式（追求极致性能），需手动安装
libmysqlclient：- Windows：从 MySQL Connector/C 下载页 获取
.msi安装包，安装后将bin/目录加入系统PATH； - Linux/macOS：通过包管理器安装（如
sudo apt install libmysqlclient-dev或brew install mysql-client）； - 验证：在 Python 中运行
import mysql.connector; print(mysql.connector.HAVE_CEXT)应返回True。
- Windows：从 MySQL Connector/C 下载页 获取
? 总结
use_pure=True 不是“降级”，而是面向现代开发环境的务实选择——它消除了二进制依赖冲突，让连接逻辑回归可预测性。对于本地开发、CI/CD 流水线及容器化部署，纯 Python 模式已成为 MySQL Connector/Python 的事实标准实践。务必在项目初始化阶段统一配置，避免因环境差异导致的连接故障。
立即学习“Python免费学习笔记（深入）”；
