使用.env文件变量连接MySQL时出现‘Access denied for user localhost (using password: NO)’错误求助

嘿，我来帮你搞定这个头疼的问题！从报错信息Access denied for user localhost (using password: NO)来看，核心问题是你的Node.js程序没有正确读取到PASSWORD环境变量——哪怕IDE提示有值，实际运行时可能解析出了问题。我之前也踩过类似的坑，给你一步步排查：

1. 先修正.env文件的格式（最常见的原因！） #

你的.env文件里等号两边加了空格，比如PASSWORD = password，dotenv默认会把这些空格也解析到变量值里，导致实际传递给MySQL的密码是" password"（带前导空格），或者干脆没正确识别变量。

把.env改成无空格的格式：

DATABASE=test
HOST=localhost
USER=root
PASSWORD=password

2. 确保dotenv在最开始加载 #

虽然你的代码里已经调用了dotenv.config()，但建议把它放在所有模块引入的最顶部，避免某些模块提前读取环境变量：

// 先加载环境变量
require('dotenv').config({ path: './.env' })

// 再引入其他模块
const path = require('path')
const hbs = require('hbs')
const express = require('express')
const mysql = require('mysql')

const app = express()
const port = process.env.PORT || 3000

// ...后续代码

3. 验证环境变量是否真的被读取到 #

在创建数据库连接前，加几行日志输出变量，确认值是否正确：

console.log('当前读取的环境变量：')
console.log('HOST:', process.env.HOST)
console.log('USER:', process.env.USER)
console.log('PASSWORD:', process.env.PASSWORD)
console.log('DATABASE:', process.env.DATABASE)

const db = mysql.createConnection({
  host: process.env.HOST,
  user: process.env.USER,
  password: process.env.PASSWORD,
  database: process.env.DATABASE
});

然后在项目根目录的终端运行node app.js，看输出的PASSWORD是不是password，有没有空格或者undefined。如果是undefined，说明.env文件路径不对。

4. 确保.env文件路径正确 #

你指定了path: './.env'，但如果是从其他目录运行app.js（比如IDE的终端默认路径不是项目根目录），就会找不到文件。可以用path.resolve来生成绝对路径，确保无论在哪运行都能找到：

const path = require('path')
require('dotenv').config({ path: path.resolve(__dirname, './.env') })

__dirname是当前脚本（app.js）所在的目录，这样路径就绝对正确了。

5. 最后排查MySQL用户权限（备选） #

因为你直接写死参数能连接，这个可能性很低，但如果上面的步骤都没用，可以检查一下root用户的权限：

• 打开Windows的MySQL Command Line Client，输入root密码进入MySQL终端
• 执行以下SQL查看用户列表：

SELECT user, host FROM mysql.user;

确保有root@localhost这条记录

• 如果需要重置密码（以防万一）：

ALTER USER 'root'@'localhost' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;

先按前4步来，尤其是第一步的空格问题，大概率能解决！

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