多模块Maven项目Dockerfile执行mvn go-offline报错求助

两个报错分别对应不同问题，和本地与Docker环境差异、插件版本bug直接相关：

• 3.1.0版本maven-dependency-plugin:go-offline内部模块依赖报错：
  本地执行命令前，本地Maven仓库已经存了之前构建生成的pl.mycustom:core:1.0等内部模块构件，解析依赖时直接读本地缓存就能通过。但Docker构建的deps阶段是全新空白环境，仅复制了各模块pom文件，没有将内部模块安装到本地仓库，Maven解析dispatcher对core的依赖时找不到本地包，去中央仓库拉取自然会失败。3.1.0版本的go-offline目标本身存在设计缺陷，不会自动将reactor（多模块构建上下文）中的内部模块安装到本地仓库，也不会按依赖顺序提前处理模块间依赖，因此直接触发报错。
• 3.2.0+版本未声明testng依赖报错：
  3.2.0及以上版本修复了reactor内部依赖解析的问题，因此能顺利通过前四个模块的依赖解析，但go-offline目标默认会拉取所有构建插件的传递依赖、可选依赖，这类依赖不需要在项目pom中显式声明，也会被纳入下载列表。报错中的testng 6.12就是某个Maven插件自带的测试类传递依赖，拉取失败一般是网络连接中央仓库超时、或者配置的Maven镜像没有同步该版本包导致的。

调整deps阶段的构建逻辑，先解决内部模块依赖问题，再过滤掉不需要的插件传递依赖，修改后的Dockerfile deps阶段片段如下：

FROM maven:3-amazoncorretto-8 as deps
WORKDIR /appbuild
COPY pom.xml pom.xml
COPY core/pom.xml core/pom.xml
COPY dispatcher/pom.xml dispatcher/pom.xml
COPY worker/pom.xml worker/pom.xml
COPY repository/pom.xml repository/pom.xml
COPY api/pom.xml api/pom.xml
RUN mkdir -p core/src/main/java dispatcher/src/main/java worker/src/main/java repository/src/main/java api/src/main/java \
    # 创建空源码目录占位，避免install阶段因无源码报错
    && mvn -B -e install -DskipTests -Dmaven.test.skip=true -Dmaven.source.skip=true -Dmaven.javadoc.skip=true \
    # 先将所有内部模块的pom安装到本地仓库，解决内部依赖找不到的问题
    && mvn -B -e org.apache.maven.plugins:maven-dependency-plugin:3.6.1:go-offline \
        -DexcludeReactor=false \
        -DincludeScope=runtime \
        -Dmdep.excludeArtifactIds=testng
    # 拉取运行时需要的所有依赖，排除非必要的testng插件传递依赖

关键逻辑说明 #

• 创建空源码目录是因为只复制pom的情况下，执行install命令Maven会检查源码路径，空目录占位可以让install只安装各模块的pom文件到本地仓库，不需要复制源码就能完成内部依赖的注册，最大化利用Docker层缓存，后续只有pom变更时才会重新执行依赖下载。
• 插件版本选3.6.1是目前稳定版，reactor依赖解析逻辑没有已知bug，加-Dmdep.excludeArtifactIds=testng直接排除不需要的插件传递依赖，不会影响项目本身的构建。
• 如果后续遇到其他非项目声明的依赖拉取失败，都可以通过这个exclude参数排除，这类依赖基本都是插件自带的测试/可选依赖，项目编译运行用不到。

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