Docker Run缓存挂载无法缓存apt-get依赖问题求助

核心原因 #

你遇到的问题不是第二个RUN覆盖缓存，也不是Docker跨构建不持久化缓存，而是两个关键因素叠加导致的：

1. 当修改第一个RUN里的依赖时，第一个RUN的指令缓存会失效，会重新执行整个指令，包括apt-get update——这会刷新/var/cache/apt里的apt索引文件（lists目录）。
2. 两个RUN共享同一个/var/cache/apt缓存目录，第二个RUN执行apt-get dist-upgrade和install时，会用新刷新的索引校验包版本，一旦索引里的包版本和缓存中的包版本不匹配（或索引更新后需要重新确认），就会触发全量重新下载。

Docker Buildkit的缓存挂载是支持跨构建持久化的，本质问题出在apt自身的索引校验机制上。

解决办法 #

把apt的缓存拆分成索引缓存和包归档缓存分开挂载，这样即使索引刷新，已下载的包只要版本匹配就能复用：

修改后的Dockerfile如下：

#(This is a minimal example, these steps take place with other steps
installing other software in between, they need to be separate)
FROM ubuntu

RUN --mount=type=cache,target=/var/cache/apt/archives,sharing=locked \
    --mount=type=cache,target=/var/lib/apt/lists,sharing=locked \
    apt-get -y update && \
    apt-get install -y \
    build-essential checkinstall cmake pkg-config yasm \
    git gfortran

RUN --mount=type=cache,target=/var/cache/apt/archives,sharing=locked \
    --mount=type=cache,target=/var/lib/apt/lists,sharing=locked \
    apt-get dist-upgrade -y && \
    apt-get install -y --no-install-recommends openjdk-17-jdk

• /var/cache/apt/archives：存储已下载的deb包，只要包版本与索引一致就会直接复用
• /var/lib/apt/lists：存储apt的索引文件，apt-get update会刷新这里的内容
• sharing=locked：确保多个RUN指令可以安全共享缓存目录，避免并发写入冲突

这样修改后，再修改第一个RUN的依赖时，第一个RUN会重新执行update刷新索引，但第二个RUN执行时，只要openjdk等包的版本没有变化，就会直接复用缓存里的deb包，不会触发全量重新下载。

另外补充：如果镜像构建不需要频繁更新系统包，可以考虑把apt-get dist-upgrade移到第一个RUN里，减少第二个RUN的操作复杂度；如果中间必须保留其他步骤，上面的拆分缓存方法依然有效。

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