构建层缓存的资源账：内存、CPU 与 IO 到底花在哪

docker builder prune 默认只清未被引用的缓存，--all 才是全清

做容量规划时，看三个数就够了：常驻内存、峰值内存、峰值持续时间。

先说结论

按「峰值 × 1.3」配内存，按「平均 × 2」配 CPU，按「峰值 × 3」留磁盘余量。

• 先量：常驻、峰值、峰值时长
• 内存：注意缓存与 RSS 的区别
• CPU：看是单核瓶颈还是多核瓶颈
• IO：随机读写最伤机械盘
• 扩容前先看是不是配置问题

三个必测的数

不测就调参，等于闭眼改代码：

• 常驻内存（RSS）：决定最低配置
• 峰值内存：决定会不会 OOM
• 峰值持续时间：决定要不要限流
• 磁盘日增量：决定备份与轮转策略

内存都去哪了

RUN --mount=type=cache 的缓存不进镜像层，但会长期占用 builder 磁盘。

Linux 的 buff/cache 会让人误判内存不足，先看 available 而不是 free。

这个服务的几个资源事实

实测下来，它吃资源的方式比较固定：

• 构建上下文会把目录打包发送给 daemon，node_modules 几百 MB 白传
• docker builder prune 默认只清未被引用的缓存，--all 才是全清
• buildx 默认 builder 的缓存上限约 10GB，超出后按最近使用淘汰

CPU 峰值怎么处理

峰值不可怕，可怕的是峰值期间没有排队机制，所有请求一起超时。

扩容还是优化

先做这三件事再谈扩容：限制并发、加缓存、异步化。多数「性能问题」在这三步之后就消失了。

还有几处容易忽略的

都是小地方，但出问题时往往就卡在这里。

• COPY . . 写在装依赖之前，改一行代码就会让整个依赖层失效
• 多阶段构建只有最后阶段的层进镜像，前面的层只留在构建缓存里
• 把 COPY . . 放最前面，改一行代码就重装全部依赖
• 没写 .dockerignore，.git 和 node_modules 全进了构建上下文
• 基础镜像用 latest，缓存天天失效还查不出原因

性能优化的第一步，是知道自己现在有多慢。