运行Vue Jest测试出现Jest worker子进程异常超出重试限制如何排查

错误本质 #

你碰到的Jest worker encountered 4 child process exceptions报错，本质是测试用例执行时持续抛出未捕获异常，Jest启动的子进程重试4次全部失败后触发的熔断报错，不是单纯的超时问题。

核心可能原因 #

对应你提供的代码，优先排查以下几个点：

• 外部依赖未Mock：useSignup依赖的useApolloClient（来自@vue/apollo-composable）和router（来自@/router）都需要初始化上下文，Jest单测环境默认没有注入这两个Vue插件的实例，直接调用resolveClient()或者router.push都会直接抛出未捕获异常。
• 测试变量未定义：你在断言expect(consoleSpy).toHaveBeenCalledWith("USER:", mockSignup)中使用的mockSignup没有提前声明定义，会直接抛出变量未定义错误。
• 断言与实际逻辑不匹配：当前你提供的useSignup代码中，console.log("USER:", validatedUser)这行已经被注释，就算前面逻辑正常运行，也不会触发你期望的控制台打印，断言必然失败。

分步排查方案 #

1. 先暴露真实错误：运行测试时加上--runInBand --no-cache参数，关闭Jest的多进程运行模式，所有错误会直接打印到控制台，不会被子进程吞掉，就能定位到具体抛错的代码行。示例命令：

npx jest 你的测试文件路径 --runInBand --no-cache

2. Mock所有外部依赖：
   • Mock@vue/apollo-composable的useApolloClient方法，返回模拟的resolveClient函数，不需要真实发起GraphQL请求。
   • Mock@/router的push方法，避免真实触发路由跳转逻辑。
3. 补全测试用的变量定义：提前声明mockSignup变量，结构和你预期的接口返回值保持一致。
4. 对齐断言与实际逻辑：如果需要测试USER日志打印，把useSignup中对应注释的代码放开，或者调整断言匹配当前实际打印的日志内容。

修复参考示例 #

测试文件开头补充以下Mock逻辑：

// 模拟Apollo客户端
jest.mock('@vue/apollo-composable', () => ({
  useApolloClient: jest.fn(() => ({
    resolveClient: jest.fn(() => ({
      query: jest.fn().mockResolvedValue({
        data: { signup: mockSignup }
      })
    }))
  }))
}))

// 模拟路由
jest.mock('@/router', () => ({
  default: {
    push: jest.fn()
  }
}))

// 提前定义mock返回值
const mockSignup = {
  token: 'test-token',
  user: {
    emailAddress: 'testuser@scoutapm.com',
    id: 'test-user-id'
  }
}

如果需要测试组件而不是单纯的useSignup函数，还要检查Jest配置是否支持pug、scss文件解析，或者直接在moduleNameMapper中配置样式和模板文件映射到空 mock 文件即可。

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