Node.js调试测试时如何在app.js中正确读取使用环境变量？

问题根源 #

Node.js 采用 CommonJS 规范加载模块时，会立即执行被导入模块的顶级代码。你当前测试代码中先导入app.js、后执行setConfig()的顺序，导致app.js中读取环境变量的逻辑执行时，自定义的环境变量还没有被写入process.env，因此无法生效。

解决方案 #

方案1：调整导入与初始化顺序（成本最低，优先推荐） #

直接调换测试文件中配置初始化和app导入的顺序即可，确保环境变量写入完成后再执行app.js的顶级逻辑：

// a.test.js 调整后代码
const { describe, it } = require('mocha');
const request = require('supertest');
const { expect } = require('chai');
const { setConfig } = require('../../../setConfig');

// 先执行环境变量配置
setConfig();
// 配置完成后再导入app
const { app } = require('../../../../app');

describe('transactionController', () => {
  it('test', async () => {
    await request(app)
      .post(`/`)
      .set('Accept', 'application/json')
      .type('application/json')
      .send()
      .expect(200);
  });
});

方案2：重构app.js为工厂函数（适合多环境复用场景） #

如果你的项目存在多套环境初始化逻辑，无法保证导入顺序，可以将app.js的初始化逻辑封装为工厂函数，避免模块导入时直接执行逻辑：

// app.js 重构后代码
const serverless = require('serverless-http');
const express = require('express');

module.exports.createApp = () => {
  const app = express();
  app.set('port', 3000);

  console.log(`app : env : ${process.env.NODE_ENV}`);
  if (process.env.NODE_ENV === 'prod' || process.env.NODE_ENV === 'dev') {
    app.listen(app.get('port'), () => {
      console.log(`Server running on ${app.get('port')} port`);
    });
    return { app: serverless(app) };
  } else {
    return { app };
  }
}

使用时先完成配置初始化，再调用工厂函数生成app实例即可：

// a.test.js 对应调整
setConfig();
const { createApp } = require('../../../../app');
const { app } = createApp();

方案3：VS Code调试配置内置环境变量（适合仅调试场景生效需求） #

如果你不需要修改业务代码，只想让调试模式下的环境变量提前生效，可以直接在VS Code的调试配置文件.vscode/launch.json中提前配置环境变量，调试启动时变量会自动注入：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Mocha调试",
      "program": "${workspaceFolder}/node_modules/mocha/bin/_mocha",
      "args": ["${file}"], // 调试当前打开的测试文件，可根据需求调整
      "env": {
        "NODE_ENV": "debug",
        "CACHE_HOST": "127.0.0.1",
        "CACHE_PORT": "6379"
      }
    }
  ]
}

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