You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

MySQL Workbench连接GCP SQL实例失败:认证插件加载异常求助

解决GCP Cloud SQL MySQL连接认证插件加载失败问题

核心问题分析

错误提示“authentication plugin cannot be loaded”,结合你使用无密码root用户连接GCP Cloud SQL的场景,根源是MySQL用户认证插件不兼容:

  • GCP Cloud SQL的MySQL 8.0+实例默认对root用户采用caching_sha2_password认证插件
  • 旧版本MySQL Workbench不支持该插件,或本地缺少对应插件文件

解决方案步骤

1. 修改root用户的认证插件为mysql_native_password

通过GCP Cloud Shell连接到你的SQL实例,执行以下SQL命令:

ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY '';
FLUSH PRIVILEGES;

若你是指定IP授权root用户,将'root'@'%'替换为'root'@'43.100.xxx.xxx'

2. 升级MySQL Workbench版本

确保你的MySQL Workbench版本在8.0.11及以上,该版本开始原生支持caching_sha2_password插件。直接升级到最新稳定版即可。

3. 验证本地插件文件(可选)

若升级后仍有问题,检查本地MySQL插件目录是否存在对应文件:

  • Windows默认路径:C:\Program Files\MySQL\MySQL Workbench 8.0 CE\lib\plugin,需存在caching_sha2_password.dll
  • Linux/macOS默认路径:/usr/lib/mysql/plugin,需存在caching_sha2_password.so
    文件缺失的话,重新安装MySQL Workbench并选择完整安装包,确保插件组件被包含。

4. 排除其他配置冗余问题

  • 确认GCP Cloud SQL授权列表中,你的笔记本IP是精确匹配(如43.100.xxx.xxx/32),避免大范围IP段导致规则冲突
  • 防火墙规则需针对Cloud SQL实例所在VPC,方向为入站,目标指向SQL实例标签/IP,协议TCP,端口3306
  • Cloud SQL的IAM所有者/编辑者权限是实例管理权限,和MySQL数据库用户连接权限无关,无需额外赋予

测试连接

完成上述操作后,重新在MySQL Workbench中测试连接即可。

内容的提问来源于stack exchange,提问作者Templeton Meshack

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.16 18:04:55