使用yarn的ReactJS项目Docker build未命中缓存问题咨询

根因说明 #

Docker COPY 指令的缓存命中依赖对应文件的内容哈希、元数据（权限、修改时间等）完全和上一次构建一致，RUN 指令的缓存命中依赖上一层缓存命中且指令本身无变更。RUN yarn install步骤缓存失效，本质是上一层COPY package.json/COPY yarn.lock步骤未命中缓存。

具体优化方案 #

• 合并COPY指令 #

  将分开复制两个文件的指令合并为一条，减少单文件元数据波动导致的缓存失效概率：

  # 替换原有两条独立COPY指令
  COPY package.json yarn.lock ./
  

• 加锁依赖版本 #

  给yarn install添加--frozen-lockfile参数，强制完全按照yarn.lock的版本安装依赖，避免动态拉取最新兼容版本导致的构建结果变动：

  RUN yarn install --frozen-lockfile
  

• 排查文件隐式变更 #

  1. 检查是否存在Git钩子、编辑器自动格式化、项目前置脚本修改package.json或yarn.lock的内容、权限
  2. 如果是在WSL、虚拟机共享文件夹、云盘同步目录下构建，可能出现文件修改时间自动变动的情况，将项目迁移到本地原生文件系统即可解决
  3. 两次构建前执行diff命令对比两个文件的内容，确认完全一致

• 排除构建参数干扰 #

  确认构建命令未添加--no-cache、动态--build-arg参数，未配置自动清理Docker缓存的定时规则。

• 可选：挂载Yarn缓存加速（BuildKit环境） #

  开启Docker BuildKit的情况下，可以挂载本地缓存目录，进一步提升依赖安装速度，不影响层缓存命中：

  RUN --mount=type=cache,target=/root/.yarn yarn install --frozen-lockfile
  

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