在AWS Linux EC2实例部署Backstage.io执行create-app命令时内存溢出报错

临时提升Node.js内存限制执行创建命令 #

Backstage初始化过程需要加载大量依赖并完成构建，默认Node.js堆内存上限不足以支撑，可通过NODE_OPTIONS参数临时扩大内存：

NODE_OPTIONS="--max-old-space-size=4096" npx @backstage/create-app@latest

• --max-old-space-size=4096代表将堆内存上限设为4GB，可根据EC2实例的可用内存调整（比如实例有8GB内存可设为8192），注意不要超过实例实际可用内存。

升级EC2实例内存配置 #

如果使用的是t2.micro这类小内存实例（1GB内存），即使临时调整内存限制也可能无法完成初始化，建议升级实例类型：

• 停止目标EC2实例
• 在实例详情页选择「修改实例类型」，更换为至少t2.small（2GB内存）或t3.medium（4GB内存）
• 启动实例后重新执行带内存参数的创建命令

清理缓存后重试 #

若之前的失败操作残留了缓存文件，可能影响后续执行，先清理缓存：

rm -rf ~/.npm ~/.cache/yarn

清理完成后再执行带内存参数的创建命令即可。

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