Heroku上Node.js应用堆内存超限问题排查（仍有可用内存）

问题现象 #

运行在Heroku上的Node.js（v16.17.0）应用频繁因堆内存耗尽崩溃，但对应Dyno仍有大量可用内存：

• Standard-2X Dyno（1GB内存）：堆内存占用至约512MB时触发崩溃
• Hobby Dyno（512MB内存）：堆内存占用至约256MB时触发崩溃

崩溃日志：

app/web.1 [4:0x4ea2840] 27490 ms: Mark-sweep 505.7 (522.4) -> 502.2 (523.1) MB, 440.3 / 0.0 ms (average mu = 0.280, current mu = 0.148) allocation failure scavenge might not succeed

app/web.1 FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory

排查过程 #

1. 排除Worker Dyno影响：错误日志明确来自app/web.1进程，与Worker Dyno无关
2. 验证堆内存限制：使用Node.js内置v8模块获取堆统计数据，代码如下：

const v8 = require('v8');

// 在触发内存泄漏的路由中添加以下代码
const heapStats = v8.getHeapStatistics();
const heapStatsMB = {...heapStats};
for (const key in heapStatsMB) {
  heapStatsMB[key] = `${((heapStatsMB[key] / 1024 / 1024)).toFixed(2)} MB`;
}

console.table(heapStatsMB);

结果显示：

• Hobby Dyno的heap_size_limit为259MB
• Standard-2X Dyno的heap_size_limit为515MB
  该数值完全匹配崩溃触发阈值，确认堆内存限制仅为Dyno可用内存的一半。

3. 官方文档对照：Node.js 12+版本堆内存限制默认基于系统可用内存，无需手动配置--optimize_for_size和--max_old_space_size参数，但实际表现与文档描述不符。

核心疑问 #

为何Heroku环境下的Node.js堆内存限制被设置为Dyno可用内存的一半？

内容的提问来源于stack exchange，提问作者Dashiell Rose Bark-Huss