Jest测试无限运行，--runInBand触发SIGSEGV信号错误求助

一、无限运行问题核心排查点 #

• 异步代码未收尾：测试中存在未resolve的Promise、未清理的定时器（setTimeout/setInterval），或未调用done()回调
• 代码逻辑死循环：检查testHelper.js和test.ts，确认是否存在while(true)这类无终止条件的循环
• Jest配置异常：是否误开启watch模式（比如脚本配置jest --watch），或testMatch/testPathPatterns匹配到大量无关文件导致测试无法结束

二、SIGSEGV段错误诱因（--runInBand触发） #

SIGSEGV是内存访问异常，常见场景：

• 版本不兼容：Node.js版本与Jest、ts-jest等依赖版本不匹配（比如Jest 29要求Node.js 14.15+）
• 第三方依赖bug：部分数据库客户端、加密类原生模块存在内存泄漏或非法内存访问问题
• 测试代码异常：虽JS中少见，但不当操作Buffer、调用有问题的原生扩展也会触发

三、结合代码片段的具体检查步骤 #

1. 检查package.json #

• 确认Jest、ts-jest（若用TS）的版本，对比Node.js版本是否在Jest官方支持范围内
• 查看scripts.test配置，若包含--watch需移除，改成"test": "jest"避免自动监听

2. 排查jest.config.js #

• 检查是否开启watchAll: true，该配置会导致测试无限循环运行
• 确认transform配置是否正确：TS项目需配置ts-jest处理.ts文件，避免编译异常引发的测试卡住
• 查看setupFilesAfterEnv/setupFiles，确认引入的testHelper.js是否存在全局未清理的异步操作

3. 分析testHelper.js #

• 检查模块加载阶段是否执行了无限循环或常驻进程逻辑（比如启动未停止的服务）
• 确认是否存在全局定时器、未resolve的Promise，且未在测试收尾时清理

4. 检查test.ts #

• 所有异步测试需正确处理：用async/await、返回Promise，或调用done()（禁止同时混用async和done）
• 排查测试用例中是否有死循环逻辑
• 检查是否存在对原生模块的不当调用（比如直接操作Buffer边界）

四、分步调试方案 #

1. 简化测试用例：清空test.ts，仅保留最简同步测试，验证基础运行是否正常：

test('基础测试验证', () => {
  expect(1).toBe(1);
});

运行jest，若正常则问题出在原有测试或helper中

2. 隔离testHelper.js：暂时在jest.config中注释对该文件的引入，重新运行测试，判断是否为helper导致的问题

3. 调整版本兼容性：切换Node.js版本（比如用nvm use 16），删除node_modules和package-lock.json后重新安装依赖，再测试

4. 内存分析：运行node --inspect-brk node_modules/.bin/jest --runInBand，用Chrome DevTools的Memory面板排查内存泄漏或异常访问

5. 重置依赖：删除node_modules、package-lock.json和Jest缓存（npx jest --clearCache），重新执行npm install后测试

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