NX Monorepo中Jest≥28执行单元测试报isFake读取错误的原因排查

以下是几个可能的核心原因：

• 全局对象初始化顺序或污染问题
  Jest 28对fake-timers模块做了底层重构，不再将isFake属性直接挂载到全局Date对象上。如果部分测试的初始化代码（比如全局setup脚本、测试前置钩子）在Jest完成fake-timers初始化流程前，就尝试访问Date.isFake，或者有自定义代码/第三方库提前修改甚至清空了全局Date对象，就会触发_global.Date为undefined的报错。Jest 27的实现逻辑没有这个严格的初始化顺序检查，因此不会出现问题。

• NX Monorepo的测试配置隔离失效
  NX Monorepo中子项目的Jest配置可能存在隔离性问题：部分子项目的配置可能禁用了fake-timers自动初始化，或者配置了冲突的setupFilesAfterEnv脚本。Jest 28对fake-timers的配置依赖更严格的加载顺序，一旦不同子项目的配置出现冲突，就会导致部分测试的全局Date对象未被正确初始化，进而触发该错误。

• 第三方依赖的Jest版本兼容性问题
  部分测试依赖的第三方库（如mock工具、日期处理库）内部依赖了Jest 27的私有API（比如Date.isFake），而Jest 28中该API已被移除或修改。只有引入了这些依赖的测试文件才会触发报错，这也符合“仅部分测试文件出错”的现象。

• 测试钩子的不规范调用
  如果某些测试文件中存在重复调用jest.useFakeTimers()的情况，或者在未完成的异步钩子（如beforeAll中包含未等待的异步操作）中调用fake-timers，Jest 28的fake-timers实现对这类不规范调用的容错性更低，可能导致全局Date对象处于未就绪状态，最终触发读取isFake的错误。Jest 27对这类场景的兼容性更好，因此不会报错。

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