解决 Navicat 等数据库连接软件连接 MySQL 8 出现 Authentication plugin 'caching_sha2_password' 错误

<think>嗯，用户遇到了mysql.connector连接MySQL8.0时出现的caching_sha2_password兼容性问题，这确实是个经典问题。结合之前的对话历史，用户应该已经知道这个错误是由于MySQL8.0默认启用了新的身份验证插件，而旧版mysql.connector尚未支持。用户引用的资料[1][2][3][4]都指向同一个解决方案：在连接字符串中添加auth_plugin参数。不过看起来用户可能在实际操作时仍遇到困难，需要更具体的指导。考虑到用户可能是开发者，应该需要技术细节和操作步骤。从技术角度看，这个问题有五个解决维度：1）修改连接参数（最快捷）2）降级MySQL账户认证方式（需数据库权限）3）升级连接驱动（最推荐）4）操作系统环境配置（解决依赖问题）5）测试方法验证。每个方案都需要考虑适用场景——比如有些用户可能没有数据库管理员权限，就只能选择修改客户端配置或升级驱动。用户最可能用到的还是添加auth_plugin的方案，但要注意不同编程语言中连接字符串的写法差异。同时发现mysql-connector-python在8.0.11版本后已经原生支持caching_sha2_password，这个信息在之前对话中没提到过，值得补充。安全方面需要提醒，mysql_native_password是旧协议，建议只作为临时方案。最佳实践还是升级驱动并使用默认的caching_sha2_password，这样既安全又避免配置麻烦。最后生成的扩展问题覆盖了常见关联需求：驱动版本选择、永久解决方案、Docker环境配置等，特别是"为什么开发和生产环境表现不同"这个问题很实用——很多开发者都会踩这个坑。</think> 以下是解决 `mysql.connector` 不支持 `caching_sha2_password` 认证插件的 **分步解决方案**，结合问题引用[1]-[4]整理最佳实践： --- ### **问题原因** MySQL 8.0+ 默认启用更安全的身份验证插件 `caching_sha2_password`，但旧版 `mysql-connector-python`（<8.0.11）不支持该协议[^1][^2]。 --- ### **解决方案** #### **方法1：连接时指定认证插件（推荐快捷修复）** 在连接参数中显式声明使用旧版插件 `mysql_native_password`： ```python import mysql.connector config = { "host": "localhost", "user": "root", "password": "your_password", # 替换为实际密码 "database": "your_db", "auth_plugin": "mysql_native_password" # 关键修复参数[^3][^4] } conn = mysql.connector.connect(**config) print("连接成功:", conn) ``` #### **方法2：修改MySQL用户认证方式（需数据库权限）** ```sql -- Step1: 登录MySQL mysql -u root -p -- Step2: 修改用户认证协议 ALTER USER 'your_user'@'localhost' IDENTIFIED WITH mysql_native_password BY 'new_password'; -- 替换用户名和密码 -- Step3: 刷新权限 FLUSH PRIVILEGES; ``` #### **方法3：升级连接器驱动（推荐）** 卸载旧版驱动，安装支持新认证的版本： ```bash pip uninstall mysql-connector-python pip install mysql-connector-python==8.0.33 # 支持caching_sha2_password的最低版本 ``` > **验证支持版本**：`mysql-connector-python` ≥ 8.0.11 原生支持该插件[^1][^4] #### **方法4：操作系统依赖修复（Linux/Mac专用）** 安装缺失的OpenSSL组件： ```bash # Ubuntu/Debian sudo apt-get install libssl-dev # CentOS sudo yum install openssl-devel ``` #### **方法5：连接测试脚本** ```python import mysql.connector try: conn = mysql.connector.connect( host="localhost", user="root", password="your_password", auth_plugin="mysql_native_password" ) print("✅ 连接成功 | MySQL版本:", conn.get_server_info()) except mysql.connector.Error as err: print("❌ 错误:", err) ``` --- ### **最佳实践建议** 1. **生产环境**：优先升级 `mysql-connector-python` 到最新版（`pip install --upgrade mysql-connector-python`） 2. **临时方案**：开发调试时可用 `auth_plugin='mysql_native_password'` 快速绕过 3. **安全警告**：`mysql_native_password` 安全性低于 `caching_sha2_password`，仅建议在测试环境使用[^1] --- ### **附加说明** - **Docker用户**：若在容器中连接MySQL 8.0，需在容器内安装新版 `mysql-connector-python` - **Windows系统**：可直接安装MySQL官方Connector（[下载地址](https://dev.mysql.com/downloads/connector/python/)）解决依赖问题 --- **