如何在含父POM的多模块Maven项目中配置增量构建？

针对你这种多模块父POM的增量构建需求，我给你整理几个实用的方案，都是业内常用的思路，你可以根据自己的场景选择：

方案一：Git + 简单脚本（最直接高效） #

这是大多数团队的首选，利用Git的变更检测能力，配合Maven的模块构建参数实现增量构建：

• 先通过Git命令提取出相对于基准版本（比如主分支、上一个发布tag）有文件变更的模块：

  # 对比当前分支和origin/main的差异，提取顶级模块目录并去重
  git diff --name-only origin/main HEAD | awk -F '/' '{print $1}' | uniq
  

  如果你的模块是嵌套结构（比如module-a/sub-module），可以调整awk的字段索引，比如{print $1"/"$2}来获取嵌套模块路径。
• 把提取到的模块列表传给Maven的-pl参数，同时加上-am参数（特别重要：自动构建依赖模块），写个Shell脚本一键执行：

  #!/bin/bash
  # 定义基准分支，可根据实际修改
  BASE_BRANCH="origin/main"
  # 获取变更模块列表，转为逗号分隔格式适配Maven参数
  CHANGED_MODULES=$(git diff --name-only $BASE_BRANCH HEAD | awk -F '/' '{print $1}' | uniq | tr '\n' ',')
  
  if [ -n "$CHANGED_MODULES" ]; then
    echo "开始构建变更模块：$CHANGED_MODULES"
    mvn clean install -pl "$CHANGED_MODULES" -am -U
  else
    echo "没有模块发生变更，跳过构建"
  fi
  

  脚本里的-U参数是强制更新快照依赖，避免本地缓存导致的问题。另外可以加个判断：如果父POM本身（根目录的pom.xml）或者核心公共模块变更，直接触发全量构建，因为这些变更会影响所有子模块。

方案二：Maven插件辅助（纯配置层面） #

如果你不想写脚本，可以尝试用Maven插件实现变更检测：

• 使用build-helper-maven-plugin的regex-property目标，在每个子模块中检查是否有文件变更，把变更模块的坐标收集到一个全局属性中。
• 再通过exec-maven-plugin调用Maven命令，传入收集到的变更模块列表。
  不过这个方案配置起来比较繁琐，每个子模块都要加配置，而且性能不如Git脚本，因为每个模块都要单独执行变更检查，适合小型多模块项目。

方案三：CI/CD平台原生能力（最省心） #

如果你的项目已经在CI/CD平台（Jenkins、GitLab CI、GitHub Actions等）上运行，直接用平台的原生变更检测功能更省心：

• 比如GitLab CI可以给每个模块定义单独的job，用only: changes规则指定只有模块内文件变更时才触发构建：

  build-module-a:
    script: mvn clean install -pl module-a -am
    only:
      changes:
        - module-a/**/*
  

• Jenkins可以用Pipeline的变更检测步骤，比如获取变更文件列表后动态生成模块列表，再调用Maven构建。
  这种方案不需要自己维护脚本，平台会帮你处理变更检测，稳定性更高。

关键注意点 #

• 永远不要忽略-am参数：变更模块可能依赖其他未变更的模块，-am会自动构建这些依赖，确保构建产物的一致性。
• 处理公共模块变更：如果父POM、公共工具模块等核心组件变更，一定要触发全量构建，因为所有子模块都依赖这些组件。
• 快照依赖的缓存问题：如果项目用了SNAPSHOT依赖，记得加-U参数强制更新，避免本地旧缓存导致的构建错误。

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