Docker BuildX中缓存挂载的使用及跨项目复用问题

一、缓存挂载的工作原理 #

RUN --mount=type=cache是Docker BuildKit提供的构建优化特性，核心是避免重复执行依赖下载、编译这类高耗时操作：

• 执行带该参数的RUN指令时，BuildKit会将一个专属的持久化缓存目录挂载到构建容器内的指定target路径（比如--mount=type=cache,target=/root/.m2）
• 首次运行该指令时，缓存目录为空，指令生成的文件（比如Maven拉取的依赖包）会被自动存入这个缓存
• 后续构建时，只要缓存未被清理，就会直接挂载复用已有内容，跳过重复的下载/编译步骤
• 该缓存完全独立于镜像层，不会被打包进最终生成的镜像文件。

二、不同项目构建间的缓存复用 #

在同一Docker daemon环境下，拥有独立Dockerfile的不同项目构建，是可以复用这类缓存的，但必须满足缓存标识匹配的条件。如果是不同机器、不同Docker daemon实例，缓存完全隔离，无法跨环境复用。

三、缓存复用的判定键 #

BuildKit通过以下几个维度生成缓存标识，只有标识完全匹配时才会复用缓存：

• 挂载的target路径：如果未指定自定义id，容器内的目标路径就是核心标识
• 自定义id参数：如果挂载时指定了id=xxx（比如--mount=type=cache,id=shared-npm-cache,target=/root/.npm），这个id会成为缓存键的核心，优先级高于target
• 缓存共享模式：比如sharing=locked（同一时间仅一个构建可写入缓存）、sharing=private（每个构建有独立缓存副本），不同共享模式会导致缓存无法跨构建复用
• 若使用--cache-from指定远程缓存源，还需要远程缓存的标识与本地匹配才能复用

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