使用node-querybuilder时，无法通过.env配置database和user导致连接失败

出现这种情况，大概率是dotenv模块未正确加载.env文件，导致process.env.NAME_DB和process.env.USER_DB取不到对应值（实际为undefined），进而数据库连接失败。直接写死字符串时，配置参数是有效的，所以能正常连接。

排查及解决步骤 #

1. 确认dotenv已安装并正确加载 #

• 首先检查项目是否安装了dotenv：

  npm list dotenv
  

  如果没有安装，执行安装命令：

  npm install dotenv --save
  

• 在项目入口文件的最顶部添加加载代码，确保在读取process.env之前完成.env文件的加载：

  require('dotenv').config();
  

  （如果是ES模块，使用import dotenv from 'dotenv'; dotenv.config();）

2. 检查.env文件的有效性 #

• 确保.env文件放在项目根目录下，和入口文件处于同一层级。
• 检查.env文件内的变量定义是否无多余空格：
  错误示例（变量值前后有空格）：

  NAME_DB= news
  USER_DB= root 
  

  正确格式（无额外空格）：

  HOST_DB=localhost
  NAME_DB=news
  USER_DB=root
  PASSWORD_DB=''
  

• 检查文件编码，确保是UTF-8无BOM格式（避免特殊字符干扰）。

3. 验证变量是否正确读取 #

在配置代码前添加打印语句，确认变量值是否正常加载：

console.log('NAME_DB:', process.env.NAME_DB);
console.log('USER_DB:', process.env.USER_DB);

如果输出为undefined，说明.env文件未被正确加载，回到步骤1和2排查；如果输出正确的值，再检查node-querybuilder的配置是否有特殊处理逻辑。

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