frontend Troubleshooting
CI 构建内存不足与进程被杀排查
CI 构建时出现 JavaScript heap out of memory、Killed 或 exit code 137，先区分 Node 堆内存不足与系统 OOM，再调整 NODE_OPTIONS=--max-old-space-size、Runner 内存和并发 job，覆盖 GitHub Actions、GitLab CI 和自建 Runner 场景。
先区分 Node 堆内存不足和系统 OOM。Node heap 报错可调 max-old-space-size，系统 killed 则要看 Runner 总内存、并发和构建缓存。
Scenario
这篇文章解决什么问题
适用于“CI 构建内存不足与进程被杀排查”对应的线上或本地排障场景。不要只根据最终报错下结论，应先把问题拆成入口、链路、目标服务和资源限制几层，再用命令逐层证实。先区分 Node 堆内存不足和系统 OOM。Node heap 报错可调 max-old-space-size，系统 killed 则要看 Runner 总内存、并发和构建缓存。
Symptoms
典型现象
- CI 构建时出现 JavaScript heap out of memory、Killed 或 exit code 137，先区分 Node 堆内存不足与系统 OOM，再调整 NODE_OPTIONS=--max-old-space-size、Runner 内存和并发 job，覆盖 GitHub Actions、GitLab CI 和自建 Runner 场景。
- 相关日志、命令或页面中反复出现 ci、build、memory 等关键词。
- 同一服务在不同机器、不同入口或不同时间段表现不一致，需要通过证据链缩小范围。
Before Debugging
排查前先确认
- 先区分浏览器运行时、构建期、SSR/水合、依赖安装和网络 API 问题。
- 保留浏览器控制台、Network 失败请求、构建日志和 lockfile 状态。
- 确认本地、CI、预览环境和生产环境的 Node 版本与环境变量是否一致。
Root Causes
常见根因分层
运行环境差异
Node 版本、包管理器、lockfile、CI 内存、浏览器 API 与 SSR 环境差异都会导致“本地好、线上坏”。
- 固定 Node/pnpm 版本
- CI 使用 frozen lockfile
- 构建后 preview 复现
客户端和服务端首屏不一致
时间、随机数、localStorage、window、viewport 条件渲染会引发 hydration mismatch 或闪烁。
- SSR 阶段输出确定内容
- 浏览器专属逻辑放 mounted/ClientOnly
- 避免首屏按 viewport 分支
浏览器安全策略和跨域
CORS、Cookie SameSite、HTTPS、混合内容和缓存策略会让接口在 Postman 可用但浏览器失败。
- 看预检 OPTIONS
- 确认凭证模式与 Allow-Origin
- 从 Network 读取真实响应
Diagnosis Path
分步诊断流程
1. 固定现场，避免追着变化状态跑
先记录故障时间、影响入口、完整错误和最近一次变更。CI 构建内存不足与进程被杀排查 这类问题经常在重启、重试或缓存刷新后短暂消失，没有现场信息会很难复盘。
- 截图或保存完整错误文本
- 记录请求域名/IP/端口/namespace/服务名
- 标出最近发布、配置、证书、镜像或依赖变更
node -v
NODE_OPTIONS=--max-old-space-size=4096 pnpm build2. 在故障发生的同一位置复现
很多误判来自测试位置不同：本机通不代表服务器通，容器内通不代表宿主机通，集群外通也不代表 Pod 内通。复现命令要尽量贴近真实流量路径。
- 从报错服务所在机器执行测试
- 必要时加 Host、SNI、namespace 或代理参数
- 把成功路径和失败路径的输出并排比较
NODE_OPTIONS=--max-old-space-size=4096 pnpm build
free -h || true
dmesg -T | tail -n 80 || true3. 读取服务端证据，而不是只看客户端提示
客户端报错通常是结果摘要。真正能区分根因的是服务端日志、内核日志、事件、进程状态或数据库状态。
- 从 CI 日志区分 JavaScript heap out of memory、Killed、exit code 137。
- 确认 Runner 内存、swap、并发 job 数和容器限制。
- Node 堆不足时设置 NODE_OPTIONS，并评估是否有过大的 sourcemap 或静态生成批量任务。
free -h || true
dmesg -T | tail -n 80 || true
du -sh node_modules .nuxt .output .next dist 2>/dev/null4. 做最小修复并立即回归验证
每次只改一个变量，修复后用同一条复现命令回测，并观察日志是否停止增长。这样可以避免多个临时改动互相掩盖。
- Node 堆不足时设置 NODE_OPTIONS，并评估是否有过大的 sourcemap 或静态生成批量任务。
- 系统 OOM 时减少并发、拆分任务或升级 Runner。
- 检查缓存目录是否无限膨胀，避免每次构建加载过多历史产物。
dmesg -T | tail -n 80 || true
du -sh node_modules .nuxt .output .next dist 2>/dev/nullCommands
排查命令与使用意图
命令 1
用于补充“CI 构建内存不足与进程被杀排查”的排查证据链。node 的输出需要结合上下文其他命令交叉验证，不要单独依赖某一条结果下结论。
node -v命令 2
用于补充“CI 构建内存不足与进程被杀排查”的排查证据链。NODE_OPTIONS=--max-old-space-size=4096 的输出需要结合上下文其他命令交叉验证，不要单独依赖某一条结果下结论。
NODE_OPTIONS=--max-old-space-size=4096 pnpm build命令 3
用于补充“CI 构建内存不足与进程被杀排查”的排查证据链。free 的输出需要结合上下文其他命令交叉验证，不要单独依赖某一条结果下结论。
free -h || true命令 4
用于读取日志或配置文件内容。重点看时间戳附近的 ERROR、FATAL、refused、timeout 等关键词。
dmesg -T | tail -n 80 || true命令 5
用于补充“CI 构建内存不足与进程被杀排查”的排查证据链。du 的输出需要结合上下文其他命令交叉验证，不要单独依赖某一条结果下结论。
du -sh node_modules .nuxt .output .next dist 2>/dev/nullRisk Notes
容易踩坑的地方
- 不要为了修 CORS 把所有来源、所有 Header 和 Credential 同时放开，这将产生严重的安全漏洞。
- 不要随手删除 lockfile 解决 install 问题，这会导致依赖版本不可控。
- 不要在未确认浏览器兼容性的情况下使用最新的 JavaScript API 或 CSS 特性。
Verification
修复后怎么确认
- 原始故障现象已经消失，且使用同一入口重新测试 CI 构建内存不足与进程被杀 能稳定成功。
- 服务端日志不再出现同类错误，监控中的错误率、重启次数、连接数或延迟回到正常区间。
- 如果做过临时绕过，已经记录恢复计划，例如还原宽松策略、补监控、补限制或提交正式配置。
Prevention
后续预防
- 把 Node/pnpm 版本、registry 和 CI 内存配置写入项目文档，确保环境一致。
- 新增 SSR 页面时检查 hydration warning，避免水合不匹配导致页面闪烁或交互异常。
- 接口跨域策略按域名白名单维护，不使用长期通配，降低安全风险。
- 在 CI 中使用 frozen lockfile 确保依赖版本可复现，避免本地和 CI 依赖不一致。
常见问题
exit code 137 是什么意思？
通常表示进程收到 SIGKILL，CI 场景常见于系统或容器内存不足被杀。
max-old-space-size 越大越好吗？
不是。它只扩大 Node 堆上限，如果机器总内存不足，反而可能更快触发系统 OOM。
Long-tail SEO
你可能正在搜索这些报错
下面这些错误原文、场景词和中英文搜索词，都是排查同类问题时常见的入口。
- CI build out of memory
- Node heap out of memory CI
- JavaScript heap out of memory build
- GitHub Actions OOM
- Docker build OOM
- pnpm build 内存不足
- NODE_OPTIONS max_old_space_size
- 前端构建内存溢出
Need More Help
这个问题还没完全解决？
把你的报错、环境和已经尝试过的步骤发给我，后续会优先补充到排障手册。