How to Quickly Detect and Resolve Maven Dependency Conflicts

View Dependency Tree

IDEA Maven tool window

Open the Maven tool window (Alt+Shift+M → View → Tool Windows → Maven), locate the project and expand the Dependencies node. The full dependency tree is displayed; conflicting or omitted JARs are highlighted in gray or red, and hovering a node shows which parent introduced the artifact.

Command line

Run the following command at the project root to print the dependency tree: mvn dependency:tree Example output (truncated):

[INFO] org.example:dependency-test:jar:1.0-SNAPSHOT
[INFO] +- org.springframework:spring-webmvc:jar:6.0.9:compile
[INFO] |  +- org.springframework:spring-beans:jar:6.0.9:compile
[INFO] |  +- org.springframework:spring-context:jar:6.0.9:compile
[INFO] |  +- org.springframework:spring-core:jar:6.0.9:compile
[INFO] |  \- org.springframework:spring-jcl:jar:6.0.9:compile
[INFO] \- org.springframework:spring-aop:jar:5.3.23:compile

If the tree is large, filter it to a specific group:

mvn dependency:tree -Dincludes=org.springframework

Maven Helper plugin (recommended)

Install the Maven Helper plugin from the IntelliJ IDEA marketplace. Open pom.xml and switch to the Dependency Analyzer tab. The plugin visualizes the tree, highlights conflicting JARs, and provides a context menu to exclude a dependency directly.

Identify Conflicting JARs

Search the tree for the same groupId:artifactId appearing with different versions. Example:

org.springframework:spring-beans:6.0.9
org.springframework:spring-beans:5.3.23 (omitted for conflict)

Maven selects the nearest version (the one declared closest to the project) and omits the other version.

Resolve Conflicts

Exclusion

Add an <exclusion> element to the upstream dependency in pom.xml to drop the unwanted version. Example:

<dependency>
  <groupId>org.springframework</groupId>
  <artifactId>spring-webmvc</artifactId>
  <version>6.0.9</version>
  <exclusions>
    <exclusion>
      <groupId>org.springframework</groupId>
      <artifactId>spring-beans</artifactId>
    </exclusion>
  </exclusions>
</dependency>

Enforce a specific version with dependencyManagement

Define the desired version in the dependencyManagement section so all transitive dependencies use it:

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-beans</artifactId>
      <version>5.3.23</version>
    </dependency>
  </dependencies>
</dependencyManagement>

Summary

View the dependency tree quickly with IntelliJ IDEA’s built‑in Maven view or the mvn dependency:tree command.

Use the Maven Helper plugin for an intuitive, visual conflict analysis.

Resolve conflicts by adding exclusion entries to upstream dependencies or by enforcing a version globally via dependencyManagement.