Jest测试中Process.env变量无法在函数外部访问的问题排查

这个问题的核心是模块加载时机和Jest的执行顺序导致的，不是Jest的设计缺陷，而是没摸透模块初始化和测试钩子的执行逻辑：

为什么会出现这个差异？ #

1. 当你在测试文件里执行const myFunc = require('./index.js');时，Node.js会立即加载并执行src/index.js里的所有模块级代码——也就是const myVar = process.env.myVar和console.log(process.env.myVar)这两行。这时候你的beforeEach钩子还没运行，process.env还是默认值，所以这两行会输出undefined。
2. 而myFunc内部的console.log(process.env.myVar)是在测试用例调用await myFunc()时执行的，这时候beforeEach已经完成了process.env的赋值，所以能正确拿到配置值。
3. 另外注意你的业务代码里有个小错误：exports.myFunc = myFunc();这里你导出的是函数执行的结果，而不是函数本身，这会导致模块加载时就调用一次myFunc，可能不是你想要的，应该改成exports.myFunc = myFunc;。

解决方法 #

根据你的需求，有两种常用的修复方式：

方式1：延迟读取process.env（推荐） #

把依赖环境变量的逻辑移到函数内部，或者用 getter 函数动态获取，避免模块加载时就固定值：

// src/index.js
async function myFunc() {
  const myVar = process.env.myVar;
  console.log(myVar); // 每次调用都会取最新的process.env值
  return somethingMeaninful();
}
exports.myFunc = myFunc; // 注意这里不要加括号

方式2：在测试中先设置环境变量再加载模块 #

利用Jest的jest.resetModules()清空模块缓存，确保每次测试前都重新加载模块，且加载前先设置好process.env：

// src/index.test.js
const config = require('../config.json');

let myFunc;

beforeEach(async () => {
  // 重置模块缓存，避免之前的模块加载结果影响
  jest.resetModules();
  // 重置process.env（推荐用扩展运算符创建新对象，避免污染全局）
  process.env = { ...process.env, ...config };
  // 现在再加载模块，模块级代码会用最新的process.env初始化
  myFunc = require('./index.js').myFunc;
})

test('sample', async () => {
  await myFunc();
  expect(somethingMeaninful).toBeCalledTimes(1);
})

这两种方式都能解决你遇到的问题，具体选哪种取决于你的业务代码结构——如果环境变量是动态变化的配置，方式1更灵活；如果必须在模块级使用环境变量，方式2更合适。

内容的提问来源于stack exchange，提问作者search-learn