jest.spyOn异常行为：新增测试文件后原有测试全部失败

问题现象 #

• 基于ESM模式的Jest + ts-jest环境，初始的index.test.ts中5个测试全部通过
• 未修改原有测试文件，新增仅含简单断言的http-request-logger.test.ts后，原有测试全部失败，process.stdout.write的Mock完全失效，控制台直接输出了本该被拦截的日志
• 把新增文件的.test后缀去掉后，所有测试又恢复正常

核心原因分析 #

这种问题本质是ESM模块的加载特性和Jest的测试运行机制冲突导致的：

1. ESM模块的缓存基于文件URL，Jest并行运行测试时，每个测试文件会启动独立的模块上下文，原有测试中对process.stdout.write的Mock无法跨上下文生效
2. ts-jest处理ESM测试文件时，新增的测试文件可能触发模块编译流程重置，导致全局Mock被意外清除

可行解决方案 #

1. 统一ESM配置，确保所有测试文件的模块规范一致 #

检查你的jest.config.ts（或.js）配置，确保ESM相关设置覆盖所有测试文件：

export default {
  preset: 'ts-jest/presets/default-esm',
  extensionsToTreatAsEsm: ['.ts'],
  moduleNameMapper: {
    '^(\\.{1,2}/.*)\\.js$': '$1',
  },
  transform: {
    '^.+\\.tsx?$': ['ts-jest', { useESM: true }],
  },
};

同时确保项目根目录的package.json中设置了"type": "module"，让所有.ts文件默认按ESM加载。

2. 强制串行运行测试，避免上下文冲突 #

在Jest配置中禁用并行测试，让所有测试文件在同一个上下文串行执行：

export default {
  // 其他配置...
  maxWorkers: 1,
};

这样可以保证Mock的作用域不会被新的测试文件上下文打断。

3. 重构Mock逻辑，确保每个测试用例的Mock独立 #

不要依赖全局一次性Mock，改用jest.spyOn在每个测试用例前后重置Mock：

// 在index.test.ts中添加
beforeEach(() => {
  // 每次测试前重新Mock
  jest.spyOn(process.stdout, 'write').mockImplementation(() => true);
});

afterEach(() => {
  // 测试后恢复原生方法
  jest.restoreAllMocks();
});

也可以把这个逻辑放到全局的setupFilesAfterEnv中，确保所有测试启动前都初始化Mock。

4. 排查新增测试文件的隐性冲突 #

哪怕新增的测试只有简单断言，也要检查它的import语句，确认有没有引入会修改process全局对象的模块——有些第三方库可能会偷偷修改stdout，导致你的Mock失效。

内容的提问来源于stack exchange，提问作者Sebastián Suárez Valencia