Jest测试中GC根堆内存被react-dom.development字符串填满的原因是什么？

根因分析 #

数千份重复react-dom.development.js字符串被GC根的全局句柄持有，是Jest独立上下文模块加载机制与React开发包调试特性共同作用的结果：

• Jest默认给每个测试文件分配独立的VM运行上下文，未配置全局模块复用时，每执行一个测试文件都会重新完整导入一次react-dom
• react-dom开发版本的构建产物内嵌完整源码字符串，用于开发阶段错误提示、DevTools数据关联等调试功能，该字符串会被挂载到当前上下文的全局引用链，无法被GC自动回收
• 测试套件规模较大时，成百上千次重复加载产生的冗余字符串会快速占满堆内存

修复方案 #

方案1：强制Jest全局复用react-dom实例（优先选用，不影响开发调试） #

在jest.config.js中添加模块映射规则，所有测试上下文复用同一份react-dom实例，避免重复加载：

module.exports = {
  // 保留原有配置，新增如下moduleNameMapper规则
  moduleNameMapper: {
    '^react-dom$': require.resolve('react-dom'),
    '^react-dom/client$': require.resolve('react-dom/client'),
  }
}

方案2：测试环境使用生产版react-dom（适合CI全量测试场景） #

不需要开发调试提示的场景下，可配置测试环境加载无调试元信息的生产版react-dom，从根源上避免大字符串驻留：

module.exports = {
  moduleNameMapper: {
    '^react-dom$': require.resolve('react-dom/profiling'),
    '^react-dom/client$': require.resolve('react-dom/client/profiling'),
  }
}

方案3：调整Jest运行参数降低内存负载 #

添加以下Jest配置，减少无效内存驻留：

module.exports = {
  resetMocks: true,
  clearMocks: true,
  resetModules: false, // 关闭单次测试后模块重置逻辑，避免重复加载依赖
  workerIdleMemoryLimit: '512MB', // 内存超过阈值自动销毁测试worker，释放内存
}

测试量较大时，可在启动命令中添加--maxWorkers=50%参数，降低单worker的内存压力。

方案4：补全测试清理逻辑 #

使用@testing-library/react的项目，确保每个测试用例结束后执行清理，切断全局引用链：

import { cleanup, render } from '@testing-library/react'

afterEach(() => {
  cleanup()
})

React 18+项目如果手动调用createRoot渲染测试组件，测试结束后必须调用root.unmount()销毁根实例。

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