执行npm install触发JavaScript堆内存不足致命错误（NPM9.4.0）

问题重现 #

执行npm install时触发核心转储，关键错误信息：

<--- 最近几次GC信息 --->

[112733:0x6df42a0]  5902114 ms: Scavenge 4014.3 (4125.8) -> 3997.8 (4124.9) MB, 5.6 / 0.0 ms  (average mu = 0.385, current mu = 0.442) allocation failure; 
[112733:0x6df42a0]  5902128 ms: Scavenge 4014.3 (4125.8) -> 3998.6 (4125.8) MB, 5.1 / 0.0 ms  (average mu = 0.385, current mu = 0.442) allocation failure; 
[112733:0x6df42a0]  5902211 ms: Scavenge 4013.8 (4126.6) -> 3998.7 (4125.8) MB, 5.7 / 0.0 ms  (average mu = 0.385, current mu = 0.442) task; 


<--- JS调用栈 --->

FATAL ERROR: Ineffective mark-compacts near heap limit Allocation failed - JavaScript堆内存不足
 1: 0xbe3c50 node::Abort() [npm i]
 2: 0xaf08b4  [npm i]
 3: 0xdcf7c0 v8::Utils::ReportOOMFailure(v8::internal::Isolate*, char const*, v8::OOMDetails const&) [npm i]
 4: 0xdcfb76 v8::internal::V8::FatalProcessOutOfMemory(v8::internal::Isolate*, char const*, v8::OOMDetails const&) [npm i]
 5: 0xfce5f5  [npm i]
 6: 0xfceba6 v8::internal::Heap::RecomputeLimits(v8::internal::GarbageCollector) [npm i]
 7: 0xfe0e96  [npm i]
 8: 0xfe1ad5 v8::internal::Heap::CollectGarbage(v8::internal::AllocationSpace, v8::internal::GarbageCollectionReason, v8::GCCallbackFlags) [npm i]
 9: 0xfbda8f v8::internal::HeapAllocator::AllocateRawWithLightRetrySlowPath(int, v8::internal::AllocationType, v8::internal::AllocationOrigin, v8::internal::AllocationAlignment) [npm i]
10: 0xfbead7 v8::internal::HeapAllocator::AllocateRawWithRetryOrFailSlowPath(int, v8::internal::AllocationType, v8::internal::AllocationOrigin, v8::internal::AllocationAlignment) [npm i]
11: 0xf9e23a v8::internal::Factory::NewFillerObject(int, v8::internal::AllocationAlignment, v8::internal::AllocationType, v8::internal::AllocationOrigin) [npm i]
12: 0x13b1b6f v8::internal::Runtime_AllocateInYoungGeneration(int, unsigned long*, v8::internal::Isolate*) [npm i]
13: 0x18383f9  [npm i]
Aborted (core dumped)

环境信息：

$ npm --version
9.4.0
$ node --version
v19.6.0

解决方案 #

• 临时提升Node.js堆内存限制：执行安装时指定更大的堆内存，比如设置为8GB（根据机器内存调整，4GB则设为4096）：

  NODE_OPTIONS="--max-old-space-size=8192" npm install
  

• 清理npm缓存：缓存损坏可能导致内存占用异常，清理后重试：

  npm cache clean --force
  npm install
  

• 降级Node.js到LTS版本：v19为非稳定版本，内存管理可能存在问题，切换到LTS版本（如v18.x或v16.x）后重新执行安装。

• 替换为pnpm安装依赖：pnpm内存利用率远高于npm，安装更高效：

  npm install -g pnpm
  pnpm install
  

• 精简依赖项：检查package.json，移除重复、无用或体积过大的依赖，减少安装过程中的内存开销。

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