已配置BuildKit仍重复下载Maven依赖问题求助

可能原因 #

• BuildKit缓存未持久化到Runner主机：你使用GitLab Runner的docker执行器，BuildKit的--mount=type=cache默认是容器内临时缓存，Job结束后容器销毁，缓存随之丢失。当前Runner配置仅挂载了/cache目录，但未将BuildKit的Maven缓存绑定到该持久化路径，导致每次Job都需重新下载依赖。
• dependency:go-offline未覆盖全部依赖：该Maven插件无法保证下载所有间接依赖（如Quarkus插件依赖、部分测试依赖），后续package阶段仍会触发新的依赖下载。
• Maven镜像的本地仓库路径不匹配：你使用的jelastic/maven镜像可能默认本地仓库并非/root/.m2（比如部分镜像用非root用户，仓库路径为/home/jelastic/.m2），导致--mount的缓存目录未生效，Maven仍会重新下载依赖到实际仓库路径。
• Runner未全局启用BuildKit或缓存驱动配置缺失：仅在Job脚本中设置DOCKER_BUILDKIT=1可能不够，若Runner未配置BuildKit的持久化存储驱动，缓存无法跨Job复用。

解决建议 #

• 持久化BuildKit缓存到Runner主机：修改Dockerfile中的RUN命令，将缓存绑定到Runner的/cache目录，确保跨Job复用：

  RUN --mount=type=cache,target=/root/.m2,source=/cache/maven-repo,sharing=locked ./mvnw dependency:go-offline
  RUN --mount=type=cache,target=/root/.m2,source=/cache/maven-repo,sharing=locked ./mvnw package -Dquarkus.profile=${TARGETENV} -DskipTests
  

  同时确保Runner配置中的volumes包含/cache（当前已配置）。
• 替换dependency:go-offline为直接依赖缓存：移除dependency:go-offline步骤，直接通过package命令依赖缓存。只要pom.xml未变化，BuildKit会复用之前的缓存层：

  RUN --mount=type=cache,target=/root/.m2 ./mvnw package -Dquarkus.profile=${TARGETENV} -DskipTests
  

  或补充插件依赖下载：

  RUN --mount=type=cache,target=/root/.m2 ./mvnw dependency:resolve dependency:resolve-plugins
  RUN --mount=type=cache,target=/root/.m2 ./mvnw package -Dquarkus.profile=${TARGETENV} -DskipTests
  

• 确认Maven镜像的本地仓库路径：在Dockerfile中添加命令查看实际仓库路径，调整--mount的target：

  RUN mvn help:evaluate -Dexpression=settings.localRepository -q -DforceStdout
  

  例如输出为/home/jelastic/.m2/repository，则修改target为该路径。
• 配置GitLab分布式缓存：在gitlab-ci.yml中添加全局缓存，将Maven依赖缓存到GitLab的分布式存储，跨Runner复用：

  cache:
    paths:
      - ~/.m2/repository/
    key: ${CI_PROJECT_ID}-maven-cache
    policy: pull-push
  

• 优化Runner的BuildKit配置：在/etc/gitlab-runner/config.toml的[runners]下添加环境变量，确保BuildKit持久化缓存：

  [[runners]]
    # 其他配置...
    environment = ["DOCKER_BUILDKIT=1", "BUILDKIT_STORAGE_DRIVER=overlay2"]
    [runners.docker]
      # 其他配置...
      volumes = ["/cache", "/var/lib/buildkit:/var/lib/buildkit"]
  

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