如何快速排查Maven父子模块结构中同一依赖的多版本问题

完全理解你的痛点——子模块多的时候手动翻dependency:tree简直是噩梦！下面几个方法能帮你快速定位不同子模块里的依赖版本差异，不用逐个模块去查：

1. 用Maven Enforcer插件自动检测版本收敛 #

这是最推荐的方案，直接让插件帮你扫描所有子模块的依赖版本一致性：

首先在父模块的pom.xml里添加Enforcer插件的配置，启用dependencyConvergence规则：

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-enforcer-plugin</artifactId>
      <version>3.4.1</version>
      <executions>
        <execution>
          <id>enforce-convergence</id>
          <goals>
            <goal>enforce</goal>
          </goals>
          <configuration>
            <rules>
              <dependencyConvergence/>
            </rules>
            <fail>false</fail> <!-- 设置为false只会警告，不会中断构建 -->
          </configuration>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

然后在父模块根目录执行命令：

mvn clean install -DskipTests

插件会自动遍历所有子模块，输出所有存在版本冲突的依赖，包括每个版本分别被哪些子模块引入，一目了然。如果把<fail>设为true，还能强制构建失败，避免版本不一致的代码上线。

2. 用Dependency Tree的Verbose模式汇总冲突 #

如果不想改pom，也可以直接在父模块执行带-Dverbose参数的dependency:tree命令，它会显示所有依赖的版本，包括被Maven依赖调解机制覆盖的旧版本（用括号标注）：

mvn dependency:tree -Dverbose -T 1C

-T 1C是并行构建，能加快多子模块的分析速度。执行后你可以搜索输出里的括号内容，或者直接查找同一个groupId:artifactId出现的不同版本，就能定位到哪些依赖在子模块里版本不一致。

3. 生成依赖列表后用文本工具分析 #

用Dependency Plugin生成所有子模块的依赖列表文件，然后用文本搜索工具找重复的artifactId：

mvn dependency:list -DoutputFile=all-dependencies.txt -DincludeScope=compile -pl . -am

-pl . -am会包含父模块和所有子模块的依赖。生成的文件里每一行都是一个依赖，格式是[groupId]:[artifactId]:[type]:[version]:[scope]，你可以用文本编辑器的查找功能，或者用命令行工具（比如Linux的grep+sort+uniq）来找出同一个artifactId对应的不同版本：

grep -E ':[a-zA-Z0-9-]+:jar:' all-dependencies.txt | cut -d: -f2,5 | sort | uniq -d

这个命令会输出所有存在多版本的artifactId和对应的版本号。

4. 用IDE的依赖分析工具 #

如果用IntelliJ IDEA或者Eclipse，它们自带的Maven依赖视图能直观展示跨子模块的依赖版本冲突：

• 在IDEA里，打开Maven工具窗口，找到父模块，右键选择Show Dependencies，在弹出的依赖图里，有版本冲突的依赖会被标红，鼠标悬停还能看到哪个子模块引入了哪个版本。
• 也可以用Dependency Analyzer插件（IDEA自带），直接搜索某个依赖，查看所有子模块里的版本情况。

这些方法都能帮你省去手动逐个查看子模块的麻烦，其中Enforcer插件的方式最自动化，适合长期维护的项目。

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