TypeScript本地应用无法读取local.env环境变量报错求助

问题详情 #

接手的TypeScript应用本地无法启动，核心问题是环境变量未被读取：

• 调试时process.env.ServiceBusUri输出undefined，引发Azure Service Bus连接报错：

  TypeError: Missing Endpoint in Connection String.
  at Object.create (C:_Development\xxx\node_modules@azure\amqp-common\dist\index.js:1564:19)
  at Function.createFromConnectionString (~\node_modules@azure\service-bus\dist\index.js:6281:52)
  at new ServiceBus (C:_Development\xxx\dist\Lib\Utils\ServiceBus.js:44:54)
  at Object. (C:_Development\xxx\dist\server.js:50:26)
  

• 已在Local.env文件中配置ServiceBusUri变量，但未被加载
• 当前VS Code调试配置launch.json如下：

  {
    // Use IntelliSense to learn about possible attributes.
    // Hover to view descriptions of existing attributes.
    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
      {
        "type": "node",
        "request": "launch",
        "name": "Chat Web Server",
        "program": "${workspaceFolder}\\dist\\server.js",
        "preLaunchTask": "npm build",
        "envFile": "${workspaceFolder}\\Env\\Local.env",
        "runtimeArgs": ["--inspect=127.0.0.1:9264"], // , "-r", "dotenv/config"
        "sourceMaps": true
      }
    ]
  }
  

排查与解决步骤 #

1. 验证env文件格式与路径 #

• 确认Local.env路径正确：检查${workspaceFolder}\\Env\\Local.env是否对应实际文件位置，可尝试改用正斜杠${workspaceFolder}/Env/Local.env（VS Code变量兼容两种斜杠）
• 确认变量格式正确：Local.env内必须使用KEY=VALUE格式，不要加引号、不要在=两侧加空格，示例：

  ServiceBusUri=Endpoint=sb://your-namespace.servicebus.windows.net/;SharedAccessKeyName=your-key-name;SharedAccessKey=your-key
  

2. 启用dotenv自动加载 #

如果项目未显式配置dotenv，即使launch.json指定了envFile也可能失效：

• 安装dotenv依赖：

  npm install dotenv --save-dev
  

• 两种加载方式二选一：
  • 方式一：代码中显式加载：在项目入口文件（如src/server.ts）最顶部添加：

    import dotenv from 'dotenv';
    dotenv.config({ path: './Env/Local.env' }); // 对应你的env文件路径
    

  • 方式二：通过调试配置加载：取消launch.json中runtimeArgs的注释，并添加路径配置：

    "runtimeArgs": ["--inspect=127.0.0.1:9264", "-r", "dotenv/config"],
    "env": {
      "DOTENV_CONFIG_PATH": "${workspaceFolder}/Env/Local.env"
    }
    

3. 确认编译任务正常完成 #

手动执行npm run build，检查dist/server.js是否为最新编译结果——如果编译任务失败或未更新文件，旧代码可能未包含环境变量加载逻辑。

4. 调试环境变量加载状态 #

在src/server.ts最顶部添加调试代码，验证变量是否被加载：

console.log('ServiceBusUri:', process.env.ServiceBusUri);

编译后启动调试，观察控制台输出：

• 若输出正确值：检查ServiceBus构造函数中是否存在变量名拼写错误（process.env的键区分大小写）
• 若输出undefined：回到步骤1和2，重新检查env文件与加载配置

5. 临时验证配置有效性 #

将环境变量直接写入launch.json的env字段测试：

"env": {
  "ServiceBusUri": "Endpoint=sb://your-namespace.servicebus.windows.net/;SharedAccessKeyName=your-key-name;SharedAccessKey=your-key"
}

如果此方式能正常运行，说明问题出在envFile的路径或格式上，需重新核对。

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