容器与云原生 / 系统课时
构建缓存为什么有时突然失效
构建缓存为什么有时突然失效
Docker 构建并不是每次都从零开始;它会尽量复用已有层。真正容易踩坑的是:Dockerfile 前面某一步一旦失去缓存,后续步骤即使内容没改,也往往要重新执行。本课用可观察的构建过程解释缓存链条,并给出更稳定的排序方式。
学习目标
- 判断某一步为什么命中或失去构建缓存
- 理解前置层变化为何会连带后续层重新构建
- 通过调整 Dockerfile 顺序减少无效重建
缓存是按层连续复用的
Dockerfile 中多数指令都会形成新的构建层或影响构建状态。构建器处理某条指令时,会比较该指令及其输入是否与已有缓存匹配;命中就复用结果,未命中则重新执行。
关键点在于缓存具有连续性。如果较前面的层已经失效,后面的步骤通常不能继续沿用原来的缓存链,而是基于新的父层重新计算。因此,一个频繁变化的 COPY . . 放得太靠前,会让后面的安装依赖、编译等昂贵步骤反复执行。

用一次构建观察缓存命中
下面创建一个最小 Python 镜像。requirements.txt 单独复制,目的是让依赖安装层只在依赖文件变化时失效。
FROM python:3.13-alpine
WORKDIR /app
COPY requirements.txt ./
RUN pip install --no-cache-dir -r requirements.txt
COPY app.py ./
CMD ["python", "app.py"]requirements.txt 可以先保持为空,app.py 写成:
print("cache demo")预期输出(直接执行 python app.py 时):
cache demo在这两个文件和 Dockerfile 所在目录执行:
docker build --progress=plain -t cache-demo .
docker build --progress=plain -t cache-demo .预期输出:第二次构建中,未发生变化的步骤会显示为已缓存。具体步骤编号和耗时会因 Docker 版本而不同。
#<ID> [<STAGE> <N>/<M>] RUN pip install --no-cache-dir -r requirements.txt
#<ID> CACHED
#<ID> [<STAGE> <N>/<M>] COPY app.py ./
#<ID> CACHED现在只修改 app.py 的输出文本,再执行同一个构建命令。由于 requirements.txt 没变,依赖安装层仍可命中缓存;从 COPY app.py ./ 开始重新构建。
哪些变化会让缓存失效
最常见的触发条件有三类。第一类是 Dockerfile 指令本身变化,例如修改 RUN 命令。第二类是指令依赖的文件发生变化,例如 COPY package.json . 所引用的文件内容变化。第三类是父层变化,也就是前面的某一步已经重新生成,后续层随新的父层继续构建。
这也是为什么“我只改了一行源码,为什么又在装依赖”通常不是 Docker 随机失效,而是 Dockerfile 把源码复制放在了依赖安装之前。
把稳定步骤放前面
构建效率高的 Dockerfile 通常遵循一个原则:变化频率低、执行成本高的步骤尽量靠前;变化频率高的源码尽量靠后。
以 Node.js 项目为例,通常先复制 package.json 和锁文件并安装依赖,再复制业务源码。这样改一个控制器文件不会自动让依赖安装层失效。相反,如果先 COPY . .,任何被纳入构建上下文的文件变化都可能提前打断缓存链。
优化之后不要只看“构建成功”,还要连续构建两次并观察 CACHED。缓存是否按预期命中,才是判断排序是否真正有效的直接证据。