配置dotenv后process.env返回undefined的修复方法及替代方案

• 确认dotenv已正确安装
  先执行npm install dotenv或yarn add dotenv安装依赖，检查项目package.json的dependencies中是否存在dotenv条目。
• 手动指定.env文件路径
  dotenv默认从执行node命令的工作目录加载.env文件，如果你的server.js存放在子目录（如src文件夹），需要显式指定.env的绝对路径，避免运行目录不同导致加载失败：

  require('dotenv').config({
    path: require('path').resolve(__dirname, '../.env') // 根据.env和server.js的相对位置调整路径层级
  })
  

• 检查.env文件命名和语法
  确认文件名就是.env，没有隐藏的后缀（如Windows系统下容易误存为.env.txt）；同时检查文件内键值对不要在等号两侧加多余空格，不要给不需要的内容加引号。
• 增加加载错误日志排查
  修改dotenv导入代码，打印加载结果确认问题：

  const dotenvResult = require('dotenv').config()
  if (dotenvResult.error) {
    console.error('dotenv加载失败：', dotenvResult.error)
  } else {
    console.log('已加载的环境变量：', dotenvResult.parsed)
  }
  

• 排查打包工具影响
  如果你的node服务是经过Webpack、Rollup等工具打包后运行的，需要确认打包配置没有过滤掉process.env相关变量，也没有把dotenv打包为客户端依赖。

• 启动命令直接注入变量
  Windows系统启动命令：set PORT=8080 && node server.js
  Linux/Mac系统启动命令：PORT=8080 node server.js
• 跨平台注入工具
  安装cross-env包后，可实现跨平台统一的环境变量注入语法：cross-env PORT=8080 node server.js
• 其他配置包
  可使用env-cmd等替代包，支持多环境配置文件、更灵活的变量规则
• 生产环境直接使用平台注入
  部署到服务器、容器或云平台时，直接使用部署平台自带的环境变量配置功能注入，无需使用dotenv加载本地文件

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