Node.js运行大型Jest测试套件时内存溢出问题：疑似V8 code_space空间耗尽

首先，你的问题不是常规的JS堆内存耗尽，也不一定是内存泄漏——核心原因是V8引擎的code_space（专门存储编译后机器码的内存区域）达到了默认128MB的上限，而这个区域和你通过--max-old-space-size设置的常规堆内存是完全分开的。

为什么会出现这个问题？ #

从你提供的堆统计和堆栈追踪能明确看出来：

• 常规老年代堆（old_space）只用了766MB，远低于你设置的2GB上限
• code_space的已用空间达到124MB，剩余可用只有512KB，已经接近128MB的默认上限
• 堆栈追踪里的RegExpMacroAssemblerX64::GetCode、RegExpCompiler::Assemble等步骤，说明崩溃发生在正则表达式编译为机器码的过程中——V8会把每个正则表达式编译成高效的机器码，存储在code_space里，复杂的正则或者频繁编译的正则会快速耗尽这个区域。

是测试套件太大还是内存泄漏？ #

两者都有可能，但结合你“测试在不同节点崩溃”的描述，更可能是大量测试用例累积编译正则导致的code_space耗尽，而非内存泄漏（内存泄漏通常会在固定测试点重复崩溃）。不过也不能完全排除泄漏：比如某些测试用例动态生成正则后，这些正则实例被意外缓存（比如挂载到全局对象、闭包中），无法被GC回收，导致code_space里的机器码一直无法释放。

排查和解决建议 #

1. 定位高频编译的正则 #

先找出哪些正则在频繁占用code_space：

• 用Node.js的--trace-regexp参数运行测试，它会打印所有正则编译的详细信息，包括正则内容和调用栈，帮你定位到代码中频繁编译正则的位置
• 重点检查：是否在循环、函数内部动态生成正则实例（比如new RegExp(\^${variable}`)`），即使是相同的正则字符串，每次调用`new RegExp()`都可能触发重新编译（V8的正则缓存是有限的）

2. 优化正则使用，减少code_space占用 #

• 复用正则实例：把常用的正则定义为模块级常量，不要在循环或函数内部重复创建。例如：

  // 不好的写法：每次调用都编译新正则
  function validateInput(input) {
    return /^[a-z0-9]+$/.test(input);
  }
  
  // 好的写法：复用同一个正则实例
  const INPUT_REGEX = /^[a-z0-9]+$/;
  function validateInput(input) {
    return INPUT_REGEX.test(input);
  }
  

• 拆分复杂正则：过于复杂的正则会生成体积更大的机器码，拆分多个简单正则分步匹配，能显著减少单个正则占用的code_space
• 避免不必要的g标志：带全局匹配标志的正则会保留lastIndex状态，不仅无法安全复用，编译后的机器码体积也可能更大

3. 调整测试运行策略 #

• 拆分测试套件：把大型测试拆分成多个小批次运行，每次测试完成后Node进程退出，code_space会被完全释放，避免累积占用。比如用Jest的--testPathPattern参数指定只运行某一类测试：

  npm test -- --testPathPattern=src/components/Button
  npm test -- --testPathPattern=src/utils
  

• 避免长时间运行单个Node进程的测试：如果你的测试是持续集成环境中运行，确保每个测试批次都启动新的Node进程，而不是在同一个进程中跑完全部测试

4. 关于增大code_space大小的问题 #

在Node.js 16.x版本中，没有公开的命令行参数可以直接调整code_space的上限——这个128MB是V8引擎的硬编码值（64位系统）。直到Node.js 18+，V8才引入了--code-space-size参数（单位为MB）来调整这个限制。如果你的项目可以升级Node.js版本，升级到18+后可以尝试：

NODE_OPTIONS="--code-space-size=256" npm test

如果无法升级Node.js，只能通过前面的正则优化和测试拆分来解决问题。

5. 验证修复效果 #

• 继续用v8.getHeapSpaceStatistics()在测试运行过程中打印code_space的使用情况，确认已用空间不再接近128MB上限
• 结合--logHeapUsage和--trace-regexp，检查正则编译的次数是否明显减少

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