构建排障 · 构建期 OOM 复盘
2080 MB
JavaScript 堆上限
134
进程退出码
>60 MB
拼音字典解压体积
2.8 G
CI 容器内存上限
本地 pnpm build 顺顺当当,代码一推到流水线,Jenkins 就在转译阶段当场暴毙——熟悉的 JavaScript heap out of memory,堆内存死死卡在 2080MB,进程 exit 134。
最搞人心态的是:同一台 Runner 节点,跑 master 分支稳如泰山,新分支必挂。显然,问题出在分支的增量代码里。但排查过程并没有想象中顺利,中途踩了两个极其逼真的"假现场"。
两次打脸的推测
下面两个推测都曾让我以为已经破案,结果先后被证伪。先看推测,再展开证据。
第一个烟雾弹:依赖源差异
在本地排查时,pnpm install 报了某个工具包 404,查证发现该包确实在官方源下架了,下意识以为是依赖损坏导致构建异常。
第二个假象:顺手留下的备份文件
排查代码时,在一处不知何时提交的 index copy.vue 里发现了一行离谱的导入,疑似把某个 Node CLI 模块引进了前端。当时以为破案了:打包工具把这玩意儿打进 Bundle 能不撑爆?
老老实实做 Diff,真凶浮出水面
不再凭直觉瞎猜,老老实实用 git diff master...branch 审查依赖变动。增量里赫然躺着一个汉字拼音转换库。一查元数据,它的解压体积居然超过 60MB——里面塞了一整部完整的汉字静态拼音字典。
Vite 在构建转译(Transform)阶段,Rollup 需要在内存中为模块构建 AST(抽象语法树)。当遇到包含数万行巨型对象字面量的字典文件时,AST 节点数量瞬间呈指数级爆炸,把内存直接顶破。
顺带发现,约定式路由插件因为通配规则,把 copy.vue 这类备份文件也默默打包了进来,无形中又给内存加了码。
那为什么本地能过?
Node V8 默认堆上限会参考宿主环境的可用内存。本地机器动辄 16G、32G,V8 自动分了 4G 以上的堆;而 CI 容器被 cgroup 限制在 2.8G 左右,V8 算出来的堆上限只有约 2GB。
60MB 的源码字典,在本地咬咬牙过去了,但在容器里成了压垮骆驼的最后一根稻草。同一个峰值、两套天花板,结果就此分岔。
cgroup 把容器锁在 2.8G,V8 只算出约 2GB 堆上限;峰值需求越过天花板,Rollup 的 AST 直接把堆顶破。
刻度为相对示意:满格 ≈ 本地堆上限 4 GB。
留给团队的避坑备忘
避坑备忘
逐条勾选,确认已经落到团队流程里(勾选状态仅保留在当前页面)。
本文属于 AI 实用主义流派 的第 54 篇肉身实战。
发表评论
分享你的想法和反馈