在TypeScript Jest测试中强制设置环境变量无效的求助

核心原因 #

你遇到的问题本质是模块加载时机导致的缓存问题：如果被测模块在测试文件顶部通过静态import导入，模块中的const myProvider逻辑会在Jest执行环境变量修改代码之前就已执行并缓存结果，后续修改process.env不会影响已经赋值的myProvider。

有效解决方案 #

方案1：动态导入被测模块（推荐） #

将静态导入改为在beforeAll中动态导入，确保环境变量设置完成后再加载模块：

let myModule;
// 保存原始环境变量
const originalEnv = { ...process.env };

beforeAll(async () => {
  // 重置模块缓存，避免之前的导入影响
  jest.resetModules();
  // 设置目标环境变量
  process.env.IS_LOCAL = 'false';
  process.env.IS_MOCK = 'true';
  // 动态导入被测模块
  myModule = await import('../path/to/your/target-module');
});

afterAll(() => {
  // 恢复原始环境变量
  process.env = originalEnv;
});

test('使用mockProvider', () => {
  // 验证provider是否为mock版本
  expect(myModule.myProvider).toBe(mockProvider);
});

方案2：用jest.spyOn mock process.env的getter #

如果需要在单个测试用例中切换环境变量，可以通过mockprocess.env的getter实现，同时重置模块缓存：

describe('Provider选择逻辑', () => {
  const originalEnv = { ...process.env };

  afterAll(() => {
    process.env = originalEnv;
  });

  test('IS_MOCK为true时使用mockProvider', () => {
    // Mock process.env的getter
    jest.spyOn(process, 'env', 'get').mockReturnValue({
      ...originalEnv,
      IS_LOCAL: 'false',
      IS_MOCK: 'true',
    });
    // 重置模块缓存
    jest.resetModules();
    // 重新导入模块
    const { myProvider } = require('../path/to/your/target-module');
    expect(myProvider).toBe(mockProvider);
  });
});

关键注意事项 #

• jest.resetModules()必须在模块导入之前执行，确保模块重新加载时使用最新的环境变量。
• 避免直接替换process.env为全新对象（比如process.env = {...}），部分Jest环境下可能导致异常，优先直接修改单个环境变量属性。
• 检查setupFiles配置是否正确：如果用setup文件，确保jest.config.js中setupFiles数组包含你的setup.ts路径，且setup.ts中的代码为同步执行（setupFiles不支持异步逻辑）。

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