Azure Pipeline运行npm run test:ci报JS堆内存溢出错误如何解决

问题表现 #

Azure Pipeline 以PR触发运行时，在npm run test:ci阶段抛出如下内存溢出错误：

FATAL ERROR: Ineffective mark-compacts near heap limit Allocation failed - JavaScript heap out of memory

报错位置参考截图：

核心原因 #

你之前尝试在NodeTool@0安装任务里通过NODE_OPTIONS设置max_old_space_size=16384的操作完全不会生效——Azure Pipeline中单个任务下声明的env配置仅作用于当前任务进程，后续执行npm脚本的步骤根本继承不到这个环境变量，运行测试时Node还是用默认的堆内存上限（64位环境下约1.4GB），内存不够自然会崩。
注意：微软托管的ubuntu-latest构建代理默认物理内存只有7GB左右，设16GB超过宿主机内存上限的话，就算参数生效也会被系统直接杀掉进程。

解决步骤 #

• 优先修正环境变量作用域
  把NODE_OPTIONS提到job层级的全局变量配置，让所有脚本步骤都能继承到，内存值设为8192（8GB）即可，不要设超过代理实际内存的数值：

  pool:
    vmImage: ubuntu-latest
  
  jobs:
    - job: Build
      condition: and(succeeded(), eq(variables['Build.Reason'], 'PullRequest'))
      variables:
        NODE_OPTIONS: --max_old_space_size=8192
      steps:
        - task: NodeTool@0
          inputs:
            versionSpec: '14.x'
          displayName: 'Install Node.js'
  
        - task: npmAuthenticate@0
          inputs:
            workingFile: .npmrc
          displayName: 'Authenticate npm'
  
        - script: npm install
          displayName: 'npm install'        
  
        - script: npm run test:ci
          displayName: 'npm run test:ci'
  
        - script: npm run lint
          displayName: 'npm run lint'
  
        - script: npm run build
          displayName: 'npm run build'
  

  如果不想全局配置，也可以只给内存消耗最高的test:ci步骤单独加环境变量，效果一致。

• 配置正确仍报错的话排查单测本身问题
  如果改完变量作用域还是报OOM，说明不是默认内存上限的问题，是测试脚本本身存在内存泄漏：

  • 如果你用Jest跑单测，可以启动时加--logHeapUsage参数，执行过程中会打印每个测试文件的内存占用，快速定位内存异常飙升的用例
  • 检查测试代码里有没有未销毁的mock、未关闭的连接/定时器、加载了超大型静态资源没有释放的情况
  • Jest配置里可以加workerIdleMemoryLimit: '1GB'，单个worker内存达到阈值就自动重启回收，避免内存累积溢出。

• 可选优化项
  你当前用的Node.js 14.x已经EOL停止维护，条件允许的话升级到Node 18/20 LTS版本，新版V8引擎的垃圾回收效率更高，同一份代码的内存占用通常会比Node14低20%以上，能减少OOM概率。

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