Node.js/Nest.js中JavaScript堆内存溢出错误无法捕获处理的问题

为什么常规错误处理抓不到内存溢出？ #

JavaScript堆内存溢出（JavaScript heap out of memory）属于V8引擎层面的致命错误，而非普通的JavaScript异常：

• 普通try-catch只能捕获同步代码中主动抛出的异常，内存溢出是V8堆内存耗尽时触发的引擎级错误，无法被JS层面的try-catch捕获。
• uncaughtException事件仅处理JS运行时未捕获的异常，内存溢出发生时V8会直接终止进程，根本来不及触发该事件。
• Nest.js的enableShutdownHooks()是用于处理优雅关闭场景（如收到SIGTERM信号），对进程被强制终止的内存溢出无效。

系统运行速度不影响这个结果——只要内存溢出触发，进程会被V8立即终止，内部的错误处理逻辑没有执行的机会。

可行的处理方案 #

唯一可靠的方式是通过外部进程监控，将内存密集型逻辑放到子进程中运行，主进程监听子进程的退出状态并处理。

1. Node.js测试示例（主进程+子进程）

主进程代码（main.js）：

const { fork } = require('child_process');

// 启动子进程执行内存密集任务
const child = fork('./memory-heavy-task.js');

// 监听子进程退出事件
child.on('exit', (code, signal) => {
  // 内存溢出的退出码通常是134（对应SIGABRT信号）
  if (code === 134 || signal === 'SIGABRT') {
    console.log('捕获到子进程内存溢出崩溃：');
    console.log('执行清理/告警/重启逻辑...');
    // 这里可以添加日志上报、重启子进程、释放资源等操作
  } else {
    console.log(`子进程正常退出，码：${code}，信号：${signal}`);
  }
});

// 监听子进程启动错误
child.on('error', (err) => {
  console.error('子进程启动失败：', err);
});

子进程代码（memory-heavy-task.js）：

// 模拟内存溢出场景
const array = [];
while (true) {
  array.push(new Array(1000000).fill('test'));
}

运行命令：

node --max-old-space-size=128 main.js

此时主进程可以稳定捕获子进程的内存溢出崩溃，执行自定义处理逻辑。

2. Nest.js中的实现方式

在Nest.js中，可以封装一个子进程服务，将内存密集型任务委托给子进程执行：

子进程任务文件（heavy-task.js）：

// 接收主进程传递的参数
process.on('message', (taskData) => {
  try {
    // 执行内存密集型逻辑
    const largeData = [];
    while (true) {
      largeData.push(new Array(1000000).fill(taskData.payload));
    }
  } catch (err) {
    // 仅处理普通异常，内存溢出无法在此捕获
    process.send({ error: err.message });
    process.exit(1);
  }
});

Nest.js服务（memory-task.service.ts）：

import { Injectable } from '@nestjs/common';
import { fork } from 'child_process';
import { join } from 'path';

@Injectable()
export class MemoryTaskService {
  async runHeavyTask(taskPayload: any): Promise<any> {
    return new Promise((resolve, reject) => {
      const child = fork(join(__dirname, 'heavy-task.js'));

      // 接收子进程的正常结果
      child.on('message', (result) => {
        resolve(result);
        child.kill();
      });

      // 监听子进程退出
      child.on('exit', (code, signal) => {
        if (code === 134 || signal === 'SIGABRT') {
          reject(new Error('任务因内存溢出失败'));
          // 这里添加告警、日志上报等处理
          console.log('内存溢出任务处理：记录日志并通知运维');
        } else if (code !== 0) {
          reject(new Error(`任务异常退出，退出码：${code}`));
        }
      });

      // 向子进程传递任务参数
      child.send({ payload: taskPayload });
    });
  }
}

关键结论 #

• 内存溢出无法在发生崩溃的进程内部捕获处理，必须通过外部进程监控。
• 子进程/集群模式是处理这类致命错误的唯一可靠方案。
• Nest.js的优雅关闭钩子不适用内存溢出场景，需单独实现进程监控逻辑。

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