最直接有效的做法是将Maven依赖下载与源码编译拆为独立层：先COPY pom.xml文件并RUN mvn dependency:go-offline预拉依赖，再COPY src源码执行mvn package，配合多阶段构建和BuildKit缓存，显著提升多模块项目缓存命中率。
把 Maven 依赖下载和源码编译拆成独立层，是提升多模块项目缓存命中率最直接有效的做法。核心不是“装得对”，而是“分得清”——只要 pom.xml 没变，依赖就不用重下；只要 src 变了，也不影响前面的依赖层复用。
先 COPY pom.xml 再 RUN 下载依赖
多模块项目中，父 pom.xml 和各子模块的 pom.xml 是依赖关系的源头。它们比 Java 源码稳定得多，应优先复制并触发依赖拉取：
- 在构建阶段（如 FROM maven:3.8-openjdk-11 AS builder）中，只 COPY 关键依赖描述文件： COPY pom.xml ./ COPY module-a/pom.xml ./module-a/ COPY module-b/pom.xml ./module-b/
- 紧接着执行离线依赖准备：RUN mvn dependency:go-offline -B -f pom.xml，确保所有传递依赖一次性下载并缓存
- 避免使用 mvn clean compile 等会触发编译的命令——此时只需“有依赖”，不需“有 class”
再 COPY 源码，最后构建打包
源码是高频变更部分，必须放在依赖层之后，防止它一改就让整个依赖安装失效：
- 按模块粒度分别 COPY：COPY module-a/src ./module-a/src、COPY module-b/src ./module-b/src，而不是一股脑 COPY . .
- 构建指令紧随其后：RUN mvn package -DskipTests -f pom.xml，此时依赖已就位，Maven 直接复用本地仓库
- 配合 .dockerignore 排除 target/、*.log、.git 等目录，避免干扰文件哈希
用多阶段构建隔离构建环境与运行时
最终镜像不需要 Maven、JDK 或编译中间产物。多阶段能彻底切断构建工具链对运行层的污染：
- 构建阶段完成 mvn package 后，各模块的 target/*.jar 已生成
- 运行阶段（FROM openjdk:11-jre-slim）只 COPY 成品：COPY --from=builder /app/module-a/target/*.jar /app/app.jar
- 这样即使你改了某模块的 pom.xml 并重新构建，运行阶段仍可复用旧的 jar 层（如果没变），且不会因 JDK 版本更新导致整层失效
进阶技巧：启用 BuildKit + 外部缓存
默认 Docker 构建器对多模块依赖感知较弱，BuildKit 能更好处理跨模块依赖图：
- 启用 BuildKit：export DOCKER_BUILDKIT=1，再执行 docker build --progress=plain .
- 在 RUN 指令中挂载 Maven 本地仓库缓存：RUN --mount=type=cache,target=/root/.m2 mvn package -f pom.xml
- CI 场景下，配合 --cache-from 拉取上一次流水线生成的镜像作为缓存源，实测多模块项目缓存命中率可达 92% 以上
