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

MySQL企业版认证插件加载失败求助:caching_sha2_password模块缺失

解决MySQL Enterprise Edition连接时caching_sha2_password加载失败的问题

我之前帮同事排查过类似的企业版MySQL连接问题,给你几个不用切换旧认证方式的可行方案:

1. 确保客户端工具是适配企业版的版本

MySQL Enterprise Edition的caching_sha2_password实现和社区版有细节差异,必须用对应版本或最新兼容版的客户端:

  • 对于MySQL Workbench:直接从Oracle官网下载和你安装的企业版MySQL同版本号的Workbench,不要用第三方渠道的旧版本——企业版配套的Workbench会自带适配的认证插件。
  • 对于HeidiSQL:更新到12.0以上的最新稳定版,新版已经完善了对企业版caching_sha2_password的支持。

2. 检查系统环境变量与插件文件

这个错误的核心是系统找不到对应的插件模块,按以下步骤排查:

  • 找到你的MySQL企业版安装路径,比如Windows系统下的C:\Program Files\MySQL\MySQL Server 8.0\lib\plugin,确认里面存在caching_sha2_password.dll文件。
  • 将这个plugin目录添加到系统PATH环境变量:
    1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
    2. 在系统变量的PATH中新增上述插件目录的完整路径
    3. 重启Workbench/HeidiSQL后再尝试连接

3. 手动指定插件路径(针对Workbench)

如果环境变量设置无效,可以在Workbench里手动指定插件位置:

  • 打开Workbench,进入「Edit」→「Preferences」→「MySQL」→「Advanced」
  • 在「Plugin Directory」输入框中填入企业版MySQL的plugin目录完整路径(比如C:\Program Files\MySQL\MySQL Server 8.0\lib\plugin)
  • 保存设置后重启Workbench

4. 验证用户的认证配置

虽然你不想切换旧方式,但可以先确认用户的认证方式是否正确:

  • 用命令行登录MySQL服务器(如果能正常登录的话):mysql -u root -p
  • 执行查询:SELECT user, plugin FROM mysql.user WHERE user='你的用户名';
  • 确认结果里的plugin是caching_sha2_password,如果不是,执行以下命令重新设置:
    ALTER USER '你的用户名'@'localhost' IDENTIFIED WITH caching_sha2_password BY '你的密码';
    

5. 安装对应版本的VC++运行库

MySQL的插件依赖微软VC++运行库,企业版可能需要特定版本:

  • 下载并安装「Microsoft Visual C++ Redistributable for Visual Studio 2019/2022」的x64版本(对应你的系统位数)
  • 安装完成后重启电脑,再尝试连接

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.05.26 11:01:04