为什么maven dependency:go-offline无法避免Docker构建时重复下载依赖

• Docker层缓存顺序错误：当前配置先复制了频繁变动的src目录，只要业务代码有修改，后续所有RUN命令的缓存都会失效，导致依赖重复下载
• 未开启Maven离线模式：执行install命令时默认会检查远程仓库的依赖更新，哪怕本地已经存在对应jar包也会发起请求触发重复下载
• dependency:go-offline默认未拉取全量依赖：默认配置不会下载Maven插件的依赖以及部分生命周期关联的可选依赖，后续执行命令时缺失的依赖会被重新下载

FROM maven:3.8.3-jdk-8 AS build
# 第一步先单独复制pom.xml，只要pom不改动，这一层之后的依赖下载都会复用缓存
COPY pom.xml /usr/src/app/
WORKDIR /usr/src/app
# 全量下载所有依赖包括插件依赖，避免后续缺失
RUN mvn dependency:go-offline -Dgo-offline.mode=full
# 再复制业务代码、启动脚本等频繁变动的文件
COPY src /usr/src/app/src  
COPY run.sh /usr/src/app
# 加-o参数开启离线模式，强制使用本地已下载的依赖，不访问远程仓库
RUN mvn -o install dependency:copy-dependencies

FROM gcr.io/distroless/java
COPY --from=build /usr/src/app/ .

ENTRYPOINT ["./run.sh"]

• 调整文件复制顺序后，只要pom.xml没有修改，dependency:go-offline对应的层会一直复用Docker缓存，不会重复执行下载
• -o（即--offline）参数会强制Maven进入离线模式，完全不访问远程仓库，彻底避免检查更新触发的重复下载
• 添加-Dgo-offline.mode=full参数后会拉取所有项目运行、构建所需的依赖，包括插件、测试、可选依赖，避免离线模式下出现依赖缺失报错

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