容器与云原生 / 系统课时
利用构建缓存
利用构建缓存
本课解决 Docker 镜像重复构建耗时的问题,通过理解缓存失效规则调整 Dockerfile 顺序,让依赖安装、源码编译等稳定步骤复用已有结果,减少开发迭代和生产发布等待时间。
学习目标
- 理解 Docker 构建缓存的匹配条件和失效范围
- 掌握按变更频率组织 Dockerfile 指令的方法
- 能够验证缓存命中效果并定位缓存未生效原因
构建缓存的工作机制
Docker 构建镜像时会为每一条 Dockerfile 指令生成缓存层。下一次构建时,Docker 会比较当前指令及相关上下文是否与历史层一致,如果匹配则直接复用结果,而不是重新执行操作。
缓存并不是简单根据命令文本判断。COPY 会受到复制文件内容变化影响,RUN 会受到前置层变化影响。一旦某一层失效,后续层通常也会重新执行。

调整 Dockerfile 指令顺序
优化缓存的核心原则是:变化频率低的内容放前面,变化频率高的内容放后面。依赖文件通常比业务源码稳定,因此应该先复制依赖描述文件并安装依赖,再复制源码。
例如 Node.js 项目中,不推荐先复制全部源码再安装依赖,因为任何源码变化都会导致依赖安装层失效。
dockerfile
FROM node:22-alpine
WORKDIR /app
# 先复制依赖清单,保证依赖层可以复用
COPY package*.json ./
RUN npm ci
# 源码变化不会影响前面的依赖缓存
COPY . .
RUN npm run build
CMD ["node", "dist/server.js"]预期结果
text
首次构建:执行 npm ci 和 npm run build
再次构建且 package.json 未变化:复用 npm ci 缓存,仅重新执行源码相关步骤这种结构适合大多数应用项目,也便于在 CI 环境中减少重复依赖下载。
查看缓存命中情况
构建时可以通过输出信息判断哪些步骤被复用。开启详细输出可以帮助分析具体失效位置。
bash
docker build --progress=plain -t demo-app:<ID> .预期输出
text
#<ID> CACHED [2/6] COPY package*.json ./
#<ID> CACHED [3/6] RUN npm ci
#<ID> RUN npm run build如果看到大量步骤重新执行,需要检查是否修改了频繁变化的文件、构建上下文是否过大,或者是否使用了会破坏缓存的参数。
常见缓存失效原因
以下情况会让缓存无法复用:
- 修改了参与
COPY的文件内容 - 调整了 Dockerfile 中指令顺序
- 使用了不可复现的构建步骤,例如依赖源内容变化
- 使用
--no-cache强制关闭缓存
实际生产构建中,应结合 .dockerignore 排除无关文件,避免日志、临时文件等变化影响缓存。
按自己的节奏,确认真正理解。