Docker多阶段构建为何无法缓存镜像层？

问题根源：你确实误解了Docker缓存机制 #

Docker的缓存是按层校验的：每一层的缓存有效性依赖于上一层的哈希值和当前指令的输入哈希。对于COPY . .指令，Docker会计算整个构建上下文（除.dockerignore排除内容）的文件校验和，只要上下文里的任何文件（包括nginx/内的文件）发生变化，这个校验和就会改变，导致COPY层的缓存直接失效。后续的RUN rm -rf nginx/和RUN npm run build都会因为上一层缓存失效而重新执行，这就是你修改nginx/内容后第一阶段仍会重建的原因。

解决方法：让第一阶段的COPY操作排除nginx目录 #

核心思路是不让nginx/目录参与第一阶段的COPY计算，这样nginx/内的文件变化就不会影响第一阶段的缓存。以下是两种实用方案：

方案1：使用Docker 23.0+的COPY --exclude选项（推荐） #

Docker 23.0版本开始支持COPY指令的--exclude参数，可以直接排除指定目录，无需调整项目结构：

FROM myimage/node:14.19.3 as build
WORKDIR /home/node

# 复制当前目录内容，但排除nginx目录
COPY --exclude=nginx . .

RUN npm run build

FROM myimage/nginx:1.23.3
 
COPY ./nginx/nginx.conf /etc/nginx/nginx.conf
// SNIP 

方案2：调整项目目录结构（适配低版本Docker） #

如果你的Docker版本低于23.0，可以把前端构建相关的文件单独放在一个子目录（比如app/），nginx/目录独立在外，第一阶段只复制前端目录：

FROM myimage/node:14.19.3 as build
WORKDIR /home/node

# 只复制前端构建所需的目录
COPY app/ .

RUN npm run build

FROM myimage/nginx:1.23.3
 
COPY ./nginx/nginx.conf /etc/nginx/nginx.conf
// SNIP 

这样修改后，nginx/目录的任何变化都不会触发第一阶段的缓存失效，只有当前端代码或依赖文件变化时，才会重新构建第一阶段，大幅提升开发时的构建速度。

内容的提问来源于stack exchange，提问作者k1eran