frontend Command
Node/Nuxt 构建内存排查命令
Node/Nuxt/Next 构建报 JavaScript heap out of memory 或 exit code 137 时排查内存的常用命令，用 NODE_OPTIONS=--max-old-space-size=4096 扩大 V8 堆，du 查看 .nuxt/.output/.next 构建产物体积，free -h 与 dmesg 判断系统 OOM。
Node heap out of memory 先试 NODE_OPTIONS，exit 137 则优先查 Runner 或容器总内存。
Scenario
什么时候用这组命令
这组命令适合在处理“Node/Nuxt 构建内存排查命令”时作为第一轮检查模板。使用时先替换占位符，再在目标机器或目标 namespace 中执行，避免在错误环境里得到误导结论。
Input
你需要先准备什么
- 先区分浏览器运行时、构建期、SSR/水合、依赖安装和网络 API 问题。
- 保留浏览器控制台、Network 失败请求、构建日志和 lockfile 状态。
- 确认本地、CI、预览环境和生产环境的 Node 版本与环境变量是否一致。
Risk Notes
执行风险
- 不要为了修 CORS 把所有来源、所有 Header 和 Credential 同时放开，这将产生严重的安全漏洞。
- 不要随手删除 lockfile 解决 install 问题，这会导致依赖版本不可控。
- 不要在未确认浏览器兼容性的情况下使用最新的 JavaScript API 或 CSS 特性。
Commands
命令详解
命令 1: 执行 NODE_OPTIONS=--max-old-space-size=4096
用于补充“Node/Nuxt 构建内存排查命令”的排查证据链。NODE_OPTIONS=--max-old-space-size=4096 的输出需要结合上下文其他命令交叉验证，不要单独依赖某一条结果下结论。
- 确认命令运行位置正确。
- 保留关键输出，方便和修复后对比。
NODE_OPTIONS=--max-old-space-size=4096 pnpm build命令 2: 执行 node
用于补充“Node/Nuxt 构建内存排查命令”的排查证据链。node 的输出需要结合上下文其他命令交叉验证，不要单独依赖某一条结果下结论。
- 确认命令运行位置正确。
- 保留关键输出，方便和修复后对比。
node -e "console.log(v8.getHeapStatistics())"命令 3: 执行 du
用于补充“Node/Nuxt 构建内存排查命令”的排查证据链。du 的输出需要结合上下文其他命令交叉验证，不要单独依赖某一条结果下结论。
- 确认命令运行位置正确。
- 保留关键输出，方便和修复后对比。
du -sh node_modules .nuxt .output .next dist 2>/dev/null命令 4: 执行 free
用于补充“Node/Nuxt 构建内存排查命令”的排查证据链。free 的输出需要结合上下文其他命令交叉验证，不要单独依赖某一条结果下结论。
- 确认命令运行位置正确。
- 保留关键输出，方便和修复后对比。
free -h || true命令 5: 执行 dmesg
用于读取日志或配置文件内容。重点看时间戳附近的 ERROR、FATAL、refused、timeout 等关键词。
- 确认命令运行位置正确。
- 保留关键输出，方便和修复后对比。
dmesg -T | tail -n 80 || trueWorkflow
建议执行顺序
按顺序执行，不要跳过确认类命令
先用只读命令确认状态，再执行会改变状态的命令。Node heap out of memory 先试 NODE_OPTIONS，exit 137 则优先查 Runner 或容器总内存。
- 记录构建失败类型和退出码。
- Node 堆不足时设置 max-old-space-size。
- 系统 OOM 时查机器内存和内核日志。
- 检查构建产物和缓存目录体积。
- 必要时关闭 sourcemap、拆分静态生成或升级 Runner。
NODE_OPTIONS=--max-old-space-size=4096 pnpm build
node -e "console.log(v8.getHeapStatistics())"
du -sh node_modules .nuxt .output .next dist 2>/dev/null把命令输出变成结论
命令本身不是结论。每次执行后要回答：目标是否存在、状态是否异常、异常是否能解释用户看到的现象。
- 记录关键字段，而不是整屏复制
- 把正常路径和异常路径输出对比
- 输出为空也要解释：是确实没有，还是权限/过滤条件不对
node -e "console.log(v8.getHeapStatistics())"
du -sh node_modules .nuxt .output .next dist 2>/dev/null
free -h || true执行前替换占位符并控制影响范围
包含 <service>、<pod>、<namespace>、<pid>、<container> 的命令必须先替换。涉及 reload、restart、KILL、vacuum、prune 的命令要确认影响范围。
- 优先在测试环境或只读模式验证
- 生产执行前保留回滚路径
- 把最终可用命令写入工单或 runbook
free -h || true
dmesg -T | tail -n 80 || trueVerification
怎么判断命令有效
- 命令已在正确机器、正确用户、正确 namespace 或正确仓库下执行。
- 输出能支撑明确判断：正常、异常、权限不足、目标不存在或需要下一跳排查。
- 对有副作用的命令，已确认执行窗口、影响范围和回滚方式。
Prevention
沉淀到日常流程
- 把 Node/pnpm 版本、registry 和 CI 内存配置写入项目文档，确保环境一致。
- 新增 SSR 页面时检查 hydration warning，避免水合不匹配导致页面闪烁或交互异常。
- 接口跨域策略按域名白名单维护，不使用长期通配，降低安全风险。
- 在 CI 中使用 frozen lockfile 确保依赖版本可复现，避免本地和 CI 依赖不一致。
常见问题
为什么本地能 build，CI 不行？
CI 的内存、CPU、容器限制和并发任务通常比本地更严格，且缓存策略不同。
Long-tail SEO
你可能正在搜索这些报错
下面这些错误原文、场景词和中英文搜索词，都是排查同类问题时常见的入口。
- node 内存溢出
- NODE_OPTIONS max-old-space-size
- node --max-old-space-size
- npm build 内存不足
- node 内存限制调整
- v8 内存设置
Need More Help
这组命令还不够贴合你的场景？
把你的系统环境、目标操作和报错贴过来，我会优先补充更具体的命令模板。