Debian下Nodejs内存怎么调

在 Debian 下调整 Node.js 的内存限制，常见场景是 堆内存不足（OOM） 或 需要跑大内存任务。下面按「常用 → 进阶 → 系统层面」给你一个完整说明。

一、最常用：通过环境变量调整（推荐）

Node.js 默认内存限制大约是：

• 64 位系统：~1.5–2 GB
• 32 位系统：~0.7 GB

1️⃣ 临时设置（命令行）

export NODE_OPTIONS="--max-old-space-size=4096"
node app.js

表示 最大堆内存 4GB

2️⃣ 永久设置（当前用户）

echo 'export NODE_OPTIONS="--max-old-space-size=4096"' >> ~/.bashrc
source ~/.bashrc

3️⃣ 只对某个 Node 程序生效

NODE_OPTIONS="--max-old-space-size=8192" node server.js

二、常见内存参数说明

✅ --max-old-space-size

最常用

• 单位：MB
• 控制 V8 老生代堆内存

--max-old-space-size=4096   # 4GB
--max-old-space-size=8192   # 8GB

✅ --max-semi-space-size

• 控制 新生代内存
• 一般不用手动改

--max-semi-space-size=64

三、Docker / systemd 场景（Debian 常见）

1️⃣ Docker 中

ENV NODE_OPTIONS="--max-old-space-size=4096"

或运行：

docker run -e NODE_OPTIONS="--max-old-space-size=4096" node:18

⚠️ Docker 内存 + Node 内存要匹配，否则会被 OOM Kill

2️⃣ systemd 服务

[Service]
Environment="NODE_OPTIONS=--max-old-space-size=4096"

然后：

systemctl daemon-reload
systemctl restart your-node-service

四、确认当前 Node 内存限制

方法 1：代码查看

console.log(process.memoryUsage());
console.log(process.versions.v8);

方法 2：直接看 V8 限制

node -e "console.log(v8.getHeapStatistics())"

五、Debian 系统层面注意事项

1️⃣ 系统内存是否足够

free -h

Node 不能突破系统物理内存 + swap

2️⃣ 是否开启 swap（防 OOM）

swapon --show

没有可临时加：

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

3️⃣ 64 位系统确认

uname -m

✅ 必须是 x86_64 / aarch64

六、常见错误 & 解决方案

❌ JavaScript heap out of memory

✅ 增加：

--max-old-space-size

❌ 设置后无效

检查：

node -p "process.env.NODE_OPTIONS"

是否被覆盖（PM2、Docker、systemd）

七、PM2（如果你在用）

pm2 start app.js --node-args="--max-old-space-size=4096"

或：

export NODE_OPTIONS="--max-old-space-size=4096"
pm2 restart all

八、推荐配置参考

如果你愿意，可以告诉我：

• Debian 版本
• Node 版本
• 是 前端构建 / 后端服务 / Docker / PM2
• 报错信息

我可以给你一个精确配置方案 ✅