构建Quarkus Docker镜像时Maven依赖缓存失效问题求助

一、Docker构建缓存失效：修改src后仍下载Quarkus依赖 #

问题根源：mvn dependency:go-offline 默认不会完全拉取Quarkus构建所需的插件依赖和动态引入的构建时依赖，导致后续package阶段仍需下载资源。

调整Dockerfile步骤，确保所有依赖（包括插件）都被缓存：

# 使用JDK17基础镜像
FROM eclipse-temurin:17-jdk-alpine AS build

# 设置Maven本地仓库路径，便于缓存
ENV MAVEN_REPO=/tmp/maven-repo
ENV MAVEN_OPTS="-Dmaven.repo.local=${MAVEN_REPO}"

# 复制pom.xml到容器，优先缓存依赖层
COPY pom.xml .

# 拉取所有依赖（包括Quarkus插件依赖）
RUN mvn dependency:go-offline \
    dependency:resolve-plugins \
    -DincludePlugins=io.quarkus:quarkus-maven-plugin

# 复制src目录（修改src时仅重新执行此层及之后步骤）
COPY src ./src

# 离线构建项目，避免重新下载依赖
RUN mvn package -DskipTests -o

# 后续的镜像精简步骤（可选）
FROM eclipse-temurin:17-jre-alpine
COPY --from=build target/quarkus-app/lib/ /deployments/lib/
COPY --from=build target/quarkus-app/*.jar /deployments/
COPY --from=build target/quarkus-app/app/ /deployments/app/
COPY --from=build target/quarkus-app/quarkus/ /deployments/quarkus/
EXPOSE 8080
CMD ["java", "-jar", "/deployments/quarkus-run.jar"]

关键调整点：

• 增加dependency:resolve-plugins并指定Quarkus插件，确保插件依赖被缓存
• 最后构建时使用-o（离线模式）强制复用缓存的依赖
• 固定Maven仓库路径，确保Docker能正确缓存依赖层

二、本地mvn package -o报错：maven-dependency-plugin:3.1.2依赖无法解析 #

问题原因：本地Maven仓库缺少该插件的传递依赖，离线模式下无法下载。

解决步骤：

1. 在线执行以下命令，拉取目标插件的所有依赖：

mvn dependency:resolve-plugins -Dplugin=org.apache.maven.plugins:maven-dependency-plugin:3.1.2

2. 或者直接在线完整构建一次，确保所有依赖（包括插件）被下载到本地仓库：

mvn clean package -DskipTests

3. 之后再执行离线构建：

mvn package -o -DskipTests

额外注意：

• 检查settings.xml中的pluginRepositories配置，确保包含Maven中央仓库或可用的镜像仓库
• 如果使用私有仓库，需确保在线构建时能正常访问该仓库，拉取所需插件依赖

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