Typescript Jest测试与ts-node脚本执行结果不一致问题求助

同样的HexChess逻辑，在Jest测试中chess.inCheck()返回true导致测试失败，但在ts-node脚本中打印结果为false，且测试偶尔会在成功/失败间切换。HexChess类无随机或第三方依赖，应为纯函数。

测试代码：

test('inCheck pawn-wrong-direction-black', () => {
  const fen = '6/7/8/9/10/k4K5/10/9/8/7/6 w - 0 1'
  const chess = new HexChess(fen)
  chess.put('g5', { color: WHITE, type: PAWN })
  expect(chess.inCheck()).toEqual(false)
})

ts-node脚本代码：

const fen = '6/7/8/9/10/k4K5/10/9/8/7/6 w - 0 1'
const chess = new HexChess(fen)
chess.put('g5', { color: WHITE, type: PAWN })
console.log(chess.inCheck())

Jest配置文件jest.config.js：

/** @type {import('ts-jest/dist/types').InitialOptionsTsJest} */
module.exports = {
  preset: 'ts-jest',
  testEnvironment: 'node',
};

package.json中的测试脚本：

"scripts": {
    "test": "jest",
}

• 检查HexChess是否存在隐式全局状态：即便你认为它是纯函数，也可能存在类静态属性、模块级全局变量被测试用例共享，导致前序测试的修改影响当前测试。比如内部的静态棋盘缓存、全局状态，会在Jest并行执行或测试顺序变化时引发结果不稳定。
  解决：确认HexChess所有状态都实例化在对象内部，无静态共享变量；或者在每个测试前通过beforeEach钩子重置环境，确保每次测试都用全新实例：

  beforeEach(() => {
    // 若存在全局状态，在此重置
  });
  

• 排查Jest模块缓存问题：Jest会缓存模块，若HexChess导出的是单例而非类，或代码修改后缓存未更新，会导致测试复用旧实例。
  解决：在jest.config.js中添加resetMocks: true或clearMocks: true；或者在测试中手动清除模块缓存：

  beforeEach(() => {
    jest.resetModules();
  });
  

  同时确保HexChess导出的是类而非单例对象。
• 验证测试执行顺序的影响：Jest默认随机化测试执行顺序，若其他测试用例修改了全局资源，会导致当前测试结果随执行顺序变化。
  解决：在jest.config.js中设置randomize: false关闭随机顺序，若结果稳定，说明是其他测试的副作用导致，需为每个测试隔离环境，确保独立性。
• 检查ts-jest与ts-node的编译差异：两者的编译配置（如目标版本、模块解析方式）可能存在细微差异，导致运行时代码不一致。
  解决：确保项目tsconfig.json与ts-jest配置兼容，在jest.config.js中指定tsconfig: './tsconfig.json'，强制ts-jest使用项目的编译规则。

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