Node.js中mysql2连接无法加载环境变量问题求助

以下是针对你遇到的环境变量加载失败问题的具体排查步骤和解决方案：

1. 确保dotenv的加载时机正确 #

环境变量必须在创建数据库连接池之前被加载，否则初始化pool时process.env的值还是undefined。修改你的数据库配置文件：

// 第一步：先加载dotenv
import dotenv from 'dotenv';
dotenv.config();

// 第二步：再导入mysql2并创建连接池
import mysql from 'mysql2/promise';

const pool = mysql.createPool({
  host: process.env.DB_HOST,
  user: process.env.DB_USER,
  password: process.env.DB_PASSWORD,
  database: process.env.DB_NAME,
  connectionLimit: 10,
});

export async function dbConnection() {
  if (!process.env.DB_HOST || !process.env.DB_USER || !process.env.DB_PASSWORD || !process.env.DB_NAME) {
    throw new Error('Missing environment variables for database connection');
  }
  console.log(process.env.DB_HOST, process.env.DB_USER, process.env.DB_PASSWORD, process.env.DB_NAME);
  const connection = await pool.getConnection();
  return connection;
}

2. 检查.env文件的位置和格式 #

• .env文件必须放在项目根目录（与package.json同级），文件名严格为.env（注意前缀的点）
• 文件内容不能有多余空格、引号，格式如下：

DB_HOST=localhost
DB_USER=root
DB_PASSWORD=your_db_password
DB_NAME=your_db_name

• 如果.env文件不在根目录，需手动指定路径：

dotenv.config({ path: './src/config/.env' }); // 替换为你的实际路径

3. 适配ES模块环境 #

如果你的项目使用ES模块（package.json中配置了"type": "module"），可以尝试以下两种方式：

方式一：使用Node.js内置的环境变量加载（Node.js 20+） #

在package.json的启动脚本中添加--env-file参数，无需手动导入dotenv：

"scripts": {
  "start": "node --env-file=.env your-entry-file.js"
}

方式二：确保dotenv版本兼容ES模块 #

安装最新版dotenv：

npm install dotenv@latest --save

4. 排查环境变量覆盖问题 #

• 在终端执行echo $DB_HOST（Linux/macOS）或echo %DB_HOST%（Windows），检查是否有系统级环境变量覆盖了.env中的配置
• 如果存在同名系统变量，要么修改系统变量，要么重命名.env中的变量名

5. 验证环境变量是否真的被加载 #

创建一个极简测试文件test-env.js，单独验证dotenv是否生效：

import dotenv from 'dotenv';
dotenv.config();
console.log('DB_HOST:', process.env.DB_HOST);
console.log('DB_USER:', process.env.DB_USER);

运行该文件，如果能正常输出变量值，说明问题出在数据库配置文件的加载顺序；如果仍无输出，检查.env文件是否存在、格式是否正确。

内容的提问来源于stack exchange，提问作者Kirk Incer Gómez