MYSQL:ER_NOT_SUPPORTED_AUTH_MODE:Client does not support authentication protocol

本文介绍如何解决在Koa项目中启动调用MySQL驱动时遇到的连接问题,通过更改数据库用户的身份验证插件为mysql_native_password,可使旧版nodejs驱动正常工作。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

今天新建一个koa项目,启动调用mysql驱动的时候报该错误。

solution:

在系统mysql终端输入下面命令,重启koa进程即可。

//yourpassword 是你的数据库账户密码,root和host也是
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'yourpassword';

了解下原因,详情见#1959#1962

大意是8.0.4开始mysql引入一个caching_sha2_password模块作为默认身份验证插件,数据库连接时验证身份的工作方式(handshake process)会与以往不同。

但以前版本的通过mysql_native_password 创建的账户仍然可以正常工作,只是验证这些账户时会切回mysql_native_password的工作方式,以此实现向下兼容。

nodejs版本尚未跟进caching_sha2_password的实现,所以需要通过上面命令来手动切换验证账号方式。

### 解决方案 当遇到 `ER_NOT_SUPPORTED_AUTH_MODE` 错误时,这通常是因为 MySQL 客户端无法支持服务器所使用的身份验证协议。此问题可以通过以下几种方式进行处理。 #### 方法一:修改用户的认证插件 通过更改用户账户的认证插件为 `mysql_native_password`,可以解决该问题。具体命令如下: ```sql ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_new_password'; ``` 这条语句的作用是将用户 `root` 的认证方式更改为旧版的 `mysql_native_password` 插件,并设置一个新的密码[^2]。 #### 方法二:更新 MySQL 客户端库 如果可能的话,建议升级 Node.js 中的 MySQL 驱动程序至最新版本。较新的驱动程序通常已经支持最新的认证协议(如 `caching_sha2_password`)。可以在项目目录下运行以下命令来安装或更新依赖项: ```bash npm install mysql2 ``` 注意,在某些情况下,使用 `mysql2` 替代原始的 `mysql` 模块可能会提供更好的兼容性和性能[^1]。 #### 方法三:强制执行数据库升级脚本 对于从较低版本迁移到较高版本的情况,比如从 MySQL 5.7 升级到 MySQL 8.0,推荐按照官方指南完成必要的迁移步骤。其中包括停止现有服务并以特殊参数重新启动实例: ```bash mysqladmin -u root -p shutdown mysqld_safe --user=mysql --datadir=/path/to/8.0-datadir --upgrade=FORCE & ``` 这些指令确保所有表结构以及元数据都得到适当调整,从而减少潜在冲突的风险[^3]。 #### 方法四:确认当前用户的认证机制 为了进一步排查问题所在,可查询系统表中的相关信息: ```sql SELECT user, host, plugin FROM mysql.user; ``` 上述 SQL 查询返回的结果可以帮助判断哪些账号仍然采用的是不受支持的老式算法[^4]。 --- ### 注意事项 尽管切换回传统密码散列函数能快速缓解症状,但从长远来看并不理想。因为这意味着牺牲了一定程度的安全保障。因此强烈鼓励开发者适时跟进技术进步,逐步淘汰过时组件。
评论 3
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值