Node.js无法连接MySQL，提示ER_ACCESS_DENIED_ERROR权限拒绝

问题详情 #

可通过MySQL Shell正常连接数据库，但在VS Code中用Nodemon运行Node.js代码时，无论使用原生mysql库还是Sequelize ORM，均抛出权限拒绝错误：

code: 'ER_ACCESS_DENIED_ERROR',
errno: 1045,
sqlMessage: "Access denied for user 'root'@'localhost' (using password: YES)",
sqlState: '28000',
fatal: true

已尝试操作 #

• 配置MySQL环境变量路径
• 执行ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '123456'修改root用户认证方式
• 创建拥有全权限的新用户尝试连接
• 切换至Sequelize框架重构数据库连接逻辑

排查与解决方案 #

1. 验证MySQL用户的主机绑定规则 #

MySQL用户权限与host字段强绑定，需确保用户允许从当前连接方式访问：

• 登录MySQL Shell，执行：

  SELECT user, host FROM mysql.user;
  

• 若目标用户的host为127.0.0.1，则Node.js代码中需将host设为127.0.0.1而非localhost（两者在MySQL中对应不同连接协议：localhost为Unix Socket，127.0.0.1为TCP连接）
• 若需允许用户从任意主机连接，可重新创建用户并授权：

  CREATE USER 'newuser'@'%' IDENTIFIED WITH mysql_native_password BY 'your_password';
  GRANT ALL PRIVILEGES ON *.* TO 'newuser'@'%';
  FLUSH PRIVILEGES;
  

2. 指定正确的连接协议（Socket/TCP） #

原生mysql库修改示例

若使用Unix Socket连接（localhost对应方式），需添加socketPath参数：

const db = mysql.createConnection({
    host: 'localhost',
    user: 'root',
    password: '123456',
    // Linux/macOS 默认路径，Windows需替换为对应socket路径
    socketPath: '/var/run/mysqld/mysqld.sock'
});

或切换为TCP连接：

const db = mysql.createConnection({
    host: '127.0.0.1',
    user: 'root',
    password: '123456',
    port: 3306
});

Sequelize修改示例

添加dialectOptions指定Socket路径：

const sequelize = new Sequelize('fake_company', 'root', '123456', {
    host: 'localhost',
    dialect: 'mysql',
    dialectOptions: {
        // 替换为你的MySQL Socket路径
        socketPath: '/var/run/mysqld/mysqld.sock'
    }
});

或改用TCP连接：

const sequelize = new Sequelize('fake_company', 'root', '123456', {
    host: '127.0.0.1',
    dialect: 'mysql',
    port: 3306
});

3. 确认VS Code的环境继承 #

• 若通过双击图标打开VS Code，可能无法继承系统环境变量，需从配置过MySQL环境变量的终端启动VS Code：

  # Linux/macOS
  code .
  
  # Windows（PowerShell）
  code .
  

4. 检查MySQL服务绑定地址 #

• 打开MySQL配置文件（my.cnf Linux/macOS 或 my.ini Windows），确认bind-address设置为127.0.0.1或0.0.0.0（允许所有IP），而非仅绑定特定外部IP
• 修改后重启MySQL服务：

  # Linux
  sudo systemctl restart mysql
  
  # Windows
  net stop MySQL80 && net start MySQL80
  

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