Node.js调试时process.env变量显示undefined的排查与解决

问题原因 #

VSCode调试器默认以工作区根目录（%PATH%\solarmonitor\）作为当前工作目录，而你的.env文件存放在backend子目录下。dotenv.config()默认会从当前工作目录加载环境变量文件，因此调试时无法找到.env，导致process.env.PORT、process.env.SOLAR_DB_URI等变量为undefined，最终触发TypeError: Cannot read properties of undefined (reading 'startsWith')错误。

解决方案 #

方案1：调整VSCode调试的工作目录 #

修改launch.json配置，添加cwd字段，指定调试时的工作目录为backend文件夹，让dotenv能找到同级的.env文件：

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "node",
            "request": "launch",
            "name": "Launch Program",
            "skipFiles": [
                "<node_internals>/**"
            ],
            "program": "${workspaceFolder}\\backend\\index.js",
            "cwd": "${workspaceFolder}\\backend" // 新增：指定工作目录
        }
    ]
}

方案2：在dotenv中明确指定.env文件路径 #

修改index.js中的dotenv.config()调用，通过绝对路径定位.env文件，摆脱对当前工作目录的依赖：

import app from "./server.js"
import mongodb from "mongodb"
import dotenv from "dotenv"
import DailyDAO from "./dao/dailyDAO.js"
// 新增导入path和url模块
import path from 'path';
import { fileURLToPath } from 'url';

// 获取当前文件的绝对路径和目录
const __filename = fileURLToPath(import.meta.url);
const __dirname = path.dirname(__filename);

// 指定.env文件的绝对路径
dotenv.config({
  path: path.join(__dirname, '.env')
})

const MongoClient = mongodb.MongoClient 
// ...后续代码不变

这种方式无论当前工作目录是什么，都能精准定位到backend目录下的.env文件。

方案3：移动.env文件到工作区根目录 #

如果项目结构允许，将.env文件从backend目录移到工作区根目录（%PATH%\solarmonitor\），这样正常运行和调试时dotenv都能找到文件。但这种方式可能破坏现有项目结构，按需选择。

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