Node.js项目.env文件引号引发数据库连接失败问题排查

这种情况其实很常见，核心问题出在环境变量的解析逻辑和数据库客户端的参数处理上，以下是具体原因：

1. dotenv版本的解析差异 #

Node.js生态里最常用的.env解析库是dotenv，但不同版本对引号的处理完全不一样：

• 旧版本（比如dotenv@8.x及更早）不会自动去除配置值两端的单/双引号，直接把引号包含在解析后的值里。比如你写DB_HOST='localhost'，最终process.env.DB_HOST的值是'localhost'（带引号），MySQL服务器会把这个带引号的字符串当作主机名，自然找不到对应的服务。
• 新版本（dotenv@10.x+）会自动剥离配置值两端的引号，这也是你查资料觉得“引号不影响”的原因——资料可能基于新版dotenv的行为。

2. MySQL客户端的参数校验逻辑 #

就算dotenv解析后带引号，要是MySQL客户端能自动处理引号也没事，但多数主流客户端（mysql、mysql2）不会做这个处理：

• 当你传入带引号的用户名、密码或主机名时，客户端会把引号当作参数的一部分发送给MySQL服务器。比如密码配置成DB_PASSWORD='123456'，客户端会用'123456'（带引号）去验证，而实际密码是123456，匹配失败就会触发连接错误。

3. 自定义.env读取逻辑的问题 #

如果你的项目没有用dotenv，而是自己写了读取.env的代码（比如用fs模块读取后手动拆分键值对），那很可能你的自定义代码没处理引号的情况，直接把带引号的字符串传给了数据库连接配置，导致参数错误。

快速验证方法 #

在数据库连接代码前加一行打印：

console.log('DB_HOST:', process.env.DB_HOST);
console.log('DB_PASSWORD:', process.env.DB_PASSWORD);

如果输出的结果带引号，那就是解析环节的问题，对应上面的原因1或3。

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