使用Express与连接池向MySQL插入数据时遭遇Access Denied错误求助

看起来这个Error: Access denied for user ''@'localhost' (using password: NO)错误的核心问题是你的Node.js应用没有正确获取到MySQL的用户名（甚至密码也没传入），导致连接时用了空用户名、无密码的方式请求连接localhost的MySQL，自然被拒绝了。结合你的代码和描述，我梳理几个排查方向：

一、先确认环境变量是否真的被正确加载 #

你提到已经验证process.env.DB_PASSWORD正确加载，但建议你在创建连接池之前，把所有相关环境变量都打印出来确认：

console.log("DB_HOST:", process.env.DB_HOST);
console.log("DB_USER:", process.env.DB_USER);
console.log("DB_PASSWORD:", process.env.DB_PASSWORD);
console.log("DB_NAME:", process.env.DB_NAME);

启动服务器后，查看控制台输出的这些值是否符合预期。如果DB_USER是空字符串，那肯定会触发这个错误。

这里容易踩的坑：

• .env文件路径是否正确？你写的dotenv.config({ path: "backend/server/.env" })需要匹配启动服务器时的工作目录。比如如果你的项目结构是：

  项目根目录/
    backend/
      server/
        server.js
        .env
  

  若在项目根目录执行node backend/server/server.js，这个路径是对的；但如果是在backend/server目录下执行node server.js，路径应该改成./.env或者直接省略path参数（dotenv默认读取当前工作目录的.env）。
• .env文件格式是否正确？变量名和值之间不要加空格：
  错误写法：DB_USER = root
  正确写法：DB_USER=root
• 有没有不小心提交了空的.env文件？或者变量名拼写错误（比如把DB_USER写成DB_USERNAME）？

二、检查MySQL用户的权限与连接匹配规则 #

MySQL的用户是区分用户名@主机的，比如root@localhost和root@%是两个完全独立的用户：

• 如果你的MySQL用户是root@%（允许任意主机连接），但应用用localhost作为host连接，MySQL会优先匹配root@localhost这个用户，如果该用户不存在或未设置密码，就会报错。
• 登录MySQL控制台，执行以下命令查看用户列表：

  SELECT user, host FROM mysql.user;
  

  确认是否存在你要使用的用户名对应的localhost主机条目，且该用户有正确密码和权限。如果没有，可以创建或修改用户：

  -- 创建允许localhost连接的用户
  CREATE USER 'your_username'@'localhost' IDENTIFIED BY 'your_password';
  -- 授予目标数据库的全部权限
  GRANT ALL PRIVILEGES ON your_database.* TO 'your_username'@'localhost';
  -- 刷新权限使配置生效
  FLUSH PRIVILEGES;
  

三、简化测试：跳过连接池直接验证连接 #

有时候连接池的配置可能有隐藏问题，你可以写一个简单的测试脚本，直接用mysql2创建单连接，验证基础连接是否正常：

import mysql from "mysql2";
import dotenv from "dotenv";

dotenv.config({ path: "backend/server/.env" });

const connection = mysql.createConnection({
  host: process.env.DB_HOST,
  user: process.env.DB_USER,
  password: process.env.DB_PASSWORD,
  database: process.env.DB_NAME,
});

connection.connect((err) => {
  if (err) {
    console.error("连接失败:", err);
    return;
  }
  console.log("成功连接到MySQL!");
  connection.end();
});

如果这个脚本也报错，那问题肯定在环境变量或MySQL用户配置；如果能成功，再排查连接池的配置（不过一般连接池和单连接的配置逻辑一致，大概率还是环境变量的问题）。

四、其他小细节排查 #

• 如果你使用Windows系统，可以试试把路径分隔符换成\\，比如backend\\server\\.env，不过这个概率较低；
• 有没有可能你的IDE或终端缓存了旧的环境变量？可以重启终端和IDE后再测试。

建议先从打印环境变量开始排查，这是最直接定位问题的方式。

备注：内容来源于stack exchange，提问作者Jhj