Node.js中.env环境变量无法访问问题求助

以下是针对你遇到的PORT、NODE_ENV等.env变量全部变为undefined问题的具体排查步骤：

• 确保dotenv加载时机正确
  必须在所有业务模块引入前加载dotenv，否则后续模块无法读取到环境变量：

  // CommonJS 写法
  require('dotenv').config();
  // 之后再引入其他模块
  const express = require('express');
  
  // ES模块写法
  import dotenv from 'dotenv';
  dotenv.config();
  import express from 'express';
  

  如果用ES模块的自动加载，需保证import 'dotenv/config'是代码第一行。

• 检查.env文件的位置与命名

  • 文件必须放在项目根目录（和package.json同级），不能放在src等子文件夹中；
  • 文件名必须是.env（如果用多环境配置，需显式指定路径，比如require('dotenv').config({ path: './.env.development' })）。

• 验证.env文件的语法规范

  • 键值对不要加多余引号（值含空格时除外），等号前后不能有空格：
    ✅ 正确写法：PORT=4000、NODE_ENV=development
    ❌ 错误写法：PORT = 4000、PORT="4000"

• 确认dotenv依赖正常
  重新安装依赖并检查package.json：

  npm install dotenv
  

  确保package.json的dependencies中存在dotenv（而非仅devDependencies，生产环境需要正常加载）。

• 排查变量加载情况
  在dotenv加载后立即打印所有环境变量，验证是否存在目标变量：

  require('dotenv').config();
  console.log(process.env); // 查看输出中是否包含PORT、NODE_ENV等变量
  

  同时检查变量名拼写是否正确（比如把NODE_ENV写成NODE_ENVI）。

• 检查启动命令配置
  如果用cross-env设置环境变量，确保脚本命令正确：

  "scripts": {
    "start": "cross-env NODE_ENV=development node server.js"
  }
  

  避免命令行变量与dotenv变量冲突。

• 清理缓存与重启服务

  • 重启编辑器/IDE（比如VS Code），避免缓存导致环境变量不更新；
  • 重启终端后重新运行项目，清除终端缓存的旧环境变量。

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