Node.js中Dotenv导入失败，无法读取.env文件问题求助

以下是针对你遇到的process.env变量返回undefined、.env配置不生效问题的排查和修复方案：

1. 修正.env文件格式 #

你的.env文件中等号前后存在空格，dotenv对空格敏感，这会导致变量解析异常甚至返回undefined。将文件内容修改为无空格的格式：

CONNECTION_URL=www.blablabla.com
PASSWORD=admin
PORT=5000

2. 确保dotenv加载路径正确 #

如果你的.env文件不在项目根目录，需要手动指定路径。可以通过console.log(__dirname)确认当前文件目录，调整路径参数：

// CommonJS语法
require('dotenv').config({ path: './正确的.env文件相对路径' });

// ES模块语法（若项目使用ES模块）
import dotenv from 'dotenv';
dotenv.config({ path: './正确的.env文件相对路径' });

3. 调整启动脚本，解决加载时序问题 #

TypeScript项目使用ts-node或ts-node-dev启动时，可能存在编译与.env加载的时序冲突。修改package.json中的启动脚本，用-r dotenv/config参数提前加载.env：

{
  "scripts": {
    "start": "node -r dotenv/config dist/index.js",
    "dev": "ts-node-dev -r dotenv/config src/index.ts"
  }
}

4. 安装Node类型声明（可选但推荐） #

虽然这不会直接解决加载失败问题，但能让TypeScript识别process.env上的自定义变量，避免编辑器报错：

npm install @types/node --save-dev

同时可在项目根目录创建env.d.ts文件添加类型声明：

declare namespace NodeJS {
  interface ProcessEnv {
    CONNECTION_URL: string;
    PASSWORD: string;
    PORT: string;
  }
}

5. 排查高优先级.env文件 #

dotenv会优先加载.env.local、.env.development等环境特定文件，如果项目中存在这类文件且未定义目标变量，会覆盖原.env的配置。检查项目根目录下是否有此类文件。

6. 更新dotenv到稳定版本 #

安装最新稳定版dotenv，避免版本兼容问题：

npm install dotenv@latest

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