未修改Docker相关文件仍下载镜像层的问题排查与优化

为什么node:18镜像没被缓存？ #

• 本地Docker环境中没有完整的node:18镜像缓存，之前的缓存可能被清理（比如执行过docker system prune），或者首次构建时未成功拉取完整镜像。
• Docker Compose的build配置中可能隐含了强制拉取镜像的设置（比如pull: always），导致每次构建都会重新拉取node:18基础镜像。
• 若Dockerfile分层顺序不合理，可能导致基础镜像层的缓存被后续修改的层打断（不过你提到未改动Dockerfile，这条可能性较低）。

仅修改JavaScript源码时避免联网下载的方案 #

1. 优化Dockerfile分层，隔离依赖安装与源码复制 #

这是最关键的一步，确保只有依赖文件变更时才重新安装依赖，源码变更不会触发依赖层的重建：

# 基础镜像
FROM node:18

# 设置工作目录
WORKDIR /app

# 先复制依赖配置文件，利用Docker缓存
COPY package.json package-lock.json ./

# 安装依赖，这一层会被缓存，除非package.json/lock变更
RUN npm install

# 最后复制源码，源码变更只会重建这一层，不会触发依赖安装或基础镜像拉取
COPY . .

# 启动命令
CMD ["node", "app.js"]

2. 手动预拉取node:18镜像到本地 #

执行以下命令确保本地有完整的基础镜像缓存：

docker pull node:18

之后构建时Docker会优先使用本地镜像，不会从网络拉取。

3. 检查Docker Compose配置，禁用强制拉取 #

打开docker-compose.yml，检查myapp-service的build部分是否有pull: always配置，如果有，将其删除或改为pull: missing（仅当本地无镜像时才拉取）：

services:
  myapp-service:
    build:
      context: .
      dockerfile: Dockerfile
      pull: missing  # 替换掉pull: always
    # 其他配置...

4. 避免清理Docker缓存 #

不要随意执行docker system prune或docker image prune命令，这类命令会删除未被使用的镜像和缓存层，导致后续构建需要重新拉取。

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