Next.js+Prisma连接MySQL报错：root身份验证失败求助

排查与修复步骤 #

1. 适配MySQL 8.0+的身份验证插件 #

MySQL 8.0及以上默认使用caching_sha2_password插件，部分Prisma依赖的驱动对该插件支持不佳，可将root用户的认证方式切换为mysql_native_password：

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

修改完成后重启MySQL服务，再尝试Prisma连接操作。

2. 核对.env文件的正确性 #

• 确保.env文件位于项目根目录，若密码包含特殊字符（如#、!），需进行URL编码（#对应%23、!对应%21）。
• 临时添加代码验证环境变量是否正常加载（测试完成后删除该代码）：

  // 在Next.js页面或API路由中添加
  console.log(process.env.DATABASE_URL);
  

  启动项目后查看输出内容，确认与你设置的数据库链接完全一致。

3. 更新Prisma版本 #

旧版Prisma可能与新版MySQL存在兼容性问题，尝试更新到最新版本：

npm update prisma @prisma/client

更新完成后重新生成Prisma客户端：

npx prisma generate

4. 将localhost替换为127.0.0.1 #

部分场景下localhost会触发socket连接而非TCP连接，换成IP地址强制使用TCP连接：

DATABASE_URL=mysql://root:mypassword@127.0.0.1:3306/nextapp

5. 确认用户连接权限 #

检查root用户的连接权限配置：

SELECT user, host FROM mysql.user WHERE user = 'root';

确保存在root@localhost的权限条目，若不存在则新建条目并完成授权操作。

内容的提问来源于stack exchange，提问作者Subu Hunter