NestJs集成测试中通过JestCLI传递并访问动态变量的问题

核心问题分析 #

你遇到的问题本质是：通过HTTP请求接收的动态SALT变量无法通过cliArgv['globals']传递到测试用例，因为Jest会优先读取jest.config.ts中的静态globals配置，忽略CLI传入的动态值。下面提供几种可靠的解决方法：

方案1：环境变量传递（最简单直接） #

利用Node.js进程环境变量的继承特性，在调用jest.runCLI前将SALT注入当前进程的环境变量，测试用例可直接读取。

步骤： #

1. HTTP控制器中设置环境变量

import * as jest from 'jest';

async function handleTestRequest(req, res) {
  // 从HTTP请求获取SALT
  const { SALT } = req.body;
  // 注入到进程环境变量
  process.env.SALT = SALT;

  // 配置jest CLI参数
  const cliArgv = {
    projects: ['somePathTo/jest-config.js'],
    globalSetup: setupScriptPath,
    globalTeardown: teardownScriptPath,
    testEnvironment: path.join(__dirname, 'custom-jest-environment.js')
  };

  // 执行测试
  const testResult = await jest.runCLI(cliArgv, domainPaths);
  
  // 可选：清理环境变量（避免影响后续请求）
  delete process.env.SALT;

  res.json(testResult);
}

2. 测试用例中直接使用

test('验证SALT变量可用', () => {
  const salt = process.env.SALT;
  expect(salt).toBeDefined();
  // 你的业务测试逻辑
});

方案2：自定义测试环境注入全局变量 #

如果希望测试用例无需通过process.env直接访问SALT，可以修改自定义测试环境，从环境变量中读取并注入到测试全局上下文。

修改自定义测试环境代码： #

import NodeEnvironment from 'jest-environment-node';

class CustomTestEnvironment extends NodeEnvironment {
  constructor(config: any, context: any) {
    super(config, context);
  }

  async setup() {
    await super.setup();
    // 从环境变量读取SALT，注入到测试全局
    this.global.SALT = process.env.SALT;
  }

  async teardown() {
    await super.teardown();
  }
}

module.exports = CustomTestEnvironment;

测试用例中直接访问全局变量： #

test('直接使用全局SALT变量', () => {
  expect(SALT).toBeDefined();
  // 业务测试逻辑
});

方案3：临时文件传递（适合复杂动态参数场景） #

如果需要传递多个复杂动态参数，可将参数写入临时文件，在globalSetup中读取并注入到测试环境。

步骤： #

1. HTTP控制器写入临时文件

import * as fs from 'fs/promises';
import * as path from 'path';
import * as jest from 'jest';

async function handleTestRequest(req, res) {
  const { SALT } = req.body;
  // 创建临时文件路径
  const tempConfigPath = path.join(__dirname, '.temp-test-config.json');
  // 写入动态参数
  await fs.writeFile(tempConfigPath, JSON.stringify({ SALT }));

  const cliArgv = {
    projects: ['somePathTo/jest-config.js'],
    globalSetup: setupScriptPath,
    globalTeardown: teardownScriptPath,
    testEnvironment: path.join(__dirname, 'custom-jest-environment.js')
  };

  const testResult = await jest.runCLI(cliArgv, domainPaths);
  
  // 清理临时文件
  await fs.unlink(tempConfigPath);

  res.json(testResult);
}

2. globalSetup脚本读取并注入

import * as fs from 'fs/promises';
import * as path from 'path';

module.exports = async function globalSetup() {
  const tempConfigPath = path.join(__dirname, '.temp-test-config.json');
  const configData = await fs.readFile(tempConfigPath, 'utf8');
  const { SALT } = JSON.parse(configData);
  
  // 注入到环境变量，供测试用例或自定义环境读取
  process.env.SALT = SALT;
};

3. 测试用例使用方式同方案1/2

为什么之前的globals方案无效？ #

Jest在初始化时会优先加载jest.config.ts中的静态配置，CLI传入的globals参数会被配置文件中的同名字段覆盖，因此无法实现动态参数传递。上述方案绕过了静态配置的限制，通过进程环境或临时文件实现动态参数的传递。

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