必须在PM2的ecosystem.config.js中通过interpreter字段显式指定含--max-old-space-size的绝对路径node命令，而非依赖环境变量或启动脚本，才能绕过宝塔受限环境限制并确保V8堆内存上限生效。
宝塔面板部署的 Node.js 项目报 FATAL ERROR: MarkCompactCollector: young object promotion failed，本质不是服务器内存不够，而是 V8 堆内存上限被默认值卡死了——必须显式调大 --max-old-space-size，且不能只改启动命令，得绕过宝塔的 PATH 和进程管理机制。
为什么在宝塔里加 --max-old-space-size 常常无效
宝塔面板默认用 PM2 或直接调用 node 启动，但多数情况下它不读取你 package.json 里的 script 参数，也不继承 shell 的 NODE_OPTIONS。更关键的是：宝塔后台执行命令时用的是受限环境，export NODE_OPTIONS=... 在 Web 界面里根本不起作用。
- PM2 启动时若未显式指定 interpreter，会走系统默认
node（可能指向旧版本或无参数） - 宝塔“网站”→“Node.js 项目”配置页里的“启动命令”，只接受完整命令字符串，不支持环境变量前缀
- 直接在 SSH 里
export NODE_OPTIONS只对当前终端 session 有效，宝塔后台任务完全看不到
PM2 配置中硬编码 --max-old-space-size
这是最稳定、宝塔兼容性最好的方式。不要依赖环境变量，把参数塞进 PM2 启动器本身。
用于自动切换项目中适合的node 版本
下载
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
- 在项目根目录创建
ecosystem.config.js，内容如下：
module.exports = {
apps: [{
name: 'my-app',
script: 'npm',
args: 'start',
interpreter: '/www/server/nodejs/v22.20.0/bin/node --max-old-space-size=8192',
// 注意：interpreter 必须是绝对路径 + 完整参数，不能拆开
watch: false,
restart_delay: 3000,
}]
};
- 确认
/www/server/nodejs/v22.20.0/bin/node是你实际安装的 Node.js 路径（可用find /www -name node -type f查） - 宝塔“网站”→“Node.js 项目”里，“PM2 配置文件”填
ecosystem.config.js，保存后重启 - 别用
pm2 start ecosystem.config.js手动启——宝塔会用自己的 pm2 实例加载，必须走它的 UI 流程
用 cross-env + 自定义 script 绕过宝塔限制
如果你坚持用宝塔的“启动命令”字段（比如不用 PM2），就得把 --max-old-space-size 塞进最终执行的那条命令里，且确保它被真正传递给 node 进程。
- 在
package.json中加一条 script：
"scripts": {
"start:large": "node --max-old-space-size=8192 ./server.js"
}
- 宝塔“启动命令”栏里填：
npm run start:large（不是npm start） - 如果项目用
nodemon，注意它默认不透传 V8 参数，要写成：nodemon --exec node --max-old-space-size=8192 ./server.js - 避免用
NODE_OPTIONS环境变量方式，宝塔 Web 界面不支持变量注入，setx或export对它无效
验证是否生效的三个关键检查点
光改了配置不等于生效。每次调整后必须手动验证，否则白忙活。
- 登录宝塔 SSH，用
ps aux | grep node看进程命令行，确认输出里真有--max-old-space-size=8192 - 在代码里加一行：
console.log('heap limit:', require('v8').getHeapStatistics().heap_size_limit);，启动后看日志输出是否 ≈ 8589934592（8GB） - 别只信
process.memoryUsage().heapTotal，它反映的是已分配量，不是上限；真正要看heap_size_limit
最容易被忽略的是：宝塔重启项目时可能缓存旧的 PM2 配置或进程状态。改完一定要点“停止”再“启动”，而不是“重载”。另外，--max-old-space-size 单位是 MB，写成 8192 没问题，但写成 8G 或 8gb 会直接失败，V8 不认单位符号。
