IONOS托管主机安装Angular CLI时出现JavaScript堆内存不足错误

问题描述 #

在IONOS无root权限托管主机上，通过nvm成功安装Node.js/npm后，执行npm install @angular/cli时出现JavaScript堆内存不足错误，尝试npm install -g --max-old-space-size=1016 @angular/cli及Node v18/19/20版本均无效。

错误日志摘要：

~$ npm install @angular/cli

[..................] \ idealTree:htdocs: sill idealTree buildDeps

<--- Last few GCs --->

[2654145:0x5267850]      731 ms: Scavenge 46.9 (67.5) -> 39.3 (67.1) MB, 4.4 / 0.0 ms  (average mu = 0.985, current mu = 0.985) task;

<--- JS stacktrace --->

FATAL ERROR: NewSpace::Rebalance Allocation failed - JavaScript heap out of memory

...（省略后续栈信息）
Aborted

可行解决方案 #

1. 本地构建项目后上传（最推荐） #

Angular CLI是开发工具，无需在托管主机安装。直接在本地完成开发和构建，再把产物上传到主机：

• 在本地电脑安装Angular CLI：npm install -g @angular/cli
• 创建并开发Angular项目：ng new my-project
• 构建生产版本：ng build --configuration production，生成的产物在dist/my-project目录下
• 将dist/my-project内的所有文件上传到托管主机的网站根目录（如htdocs）

2. 正确设置Node内存限制 #

之前的命令未正确传递内存参数给Node，需通过NODE_OPTIONS环境变量指定：

# 临时设置内存限制并全局安装CLI
NODE_OPTIONS="--max-old-space-size=2048" npm install -g @angular/cli

或分步执行：

export NODE_OPTIONS="--max-old-space-size=2048"
npm install -g @angular/cli

注：2048代表2GB内存，若主机内存不足，可尝试1536（1.5GB），但需确保主机有足够可用内存。

3. 安装低版本Angular CLI #

新版本Angular CLI依赖更多，内存占用更高，尝试安装稳定的旧版本：

NODE_OPTIONS="--max-old-space-size=2048" npm install -g @angular/cli@16.2.0

4. 项目本地安装CLI（非全局） #

若必须在主机操作项目，可仅在项目内安装CLI，避免全局安装的内存开销：

• 本地初始化项目后，将package.json、package-lock.json上传到主机项目目录
• 在主机执行：

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

安装完成后，可通过npx ng调用本地CLI执行命令（如构建）

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