树莓派4 Node.js V16.11.1 JavaScript堆内存分配失败 常规方案无效

你的问题核心特征是sudo运行正常、普通用户运行所有Node相关命令都溢出、调堆大小参数不生效，本质不是真的系统内存不足，而是普通用户的运行限制、环境变量配置或权限异常导致的，按以下步骤排查修复：

1 检查普通用户的进程内存限制 #

你报错日志中GC阶段仅分配0.3MB内存就触发失败，符合ulimit内存限制过小的特征：

• 普通用户下执行命令查看当前内存限制：
  ulimit -a
• 查看返回结果中max memory size、virtual memory两项的数值，如果值小于1024000（单位KB）就说明存在限制。
  临时生效修复：执行以下命令

  ulimit -v unlimited
  ulimit -m unlimited
  

  永久生效修复：编辑/etc/security/limits.conf文件，末尾添加两行（替换为你自己的用户名）：

  你的用户名 soft as unlimited
  你的用户名 hard as unlimited
  

  保存后重启设备生效。

2 排查普通用户环境变量的错误配置 #

sudo执行命令时默认不会继承普通用户的环境变量，你大概率在普通用户的环境变量配置中写入了错误的Node参数：

• 普通用户下执行命令查看当前Node相关环境变量：
  echo $NODE_OPTIONS
• 如果返回结果不是空值或者参数异常，去以下配置文件中查找删除错误的NODE_OPTIONS配置行：
  • ~/.bashrc
  • ~/.profile
  • ~/.bash_profile
  • /etc/profile
    修改完成后执行source ~/.bashrc生效，或者重启终端。

3 修复Node相关目录的权限异常 #

如果你的Node.js是用root权限安装的，普通用户没有读取Node核心目录、缓存目录的权限也会触发该异常：

• 修复npm缓存目录权限（替换为你自己的用户名和用户组）：
  sudo chown -R 你的用户名:你的用户组 ~/.npm
• 修复全局Node模块目录权限：
  sudo chown -R 你的用户名:你的用户组 /usr/local/lib/node_modules

4 适配32位系统的内存参数 #

如果你装的是32位树莓派系统，Node.js也是32位版本的话，最大可配置堆内存不能超过3GB，你之前设置的4096参数不兼容，可以尝试调小参数测试：
node --max-old-space-size=1024 -e "console.log('test')"

完成以上排查后重新开终端测试Node命令即可恢复正常。

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