Quickly Detect and Resolve Maven Dependency Conflicts in IntelliJ

1. View the Dependency Tree

In IntelliJ open the Maven tool window (Alt+Shift+M → View → Tool Windows → Maven), expand your project and locate the Dependencies node. The full tree is displayed, and IDEA highlights excluded or conflicting JARs in gray or red. Hovering a dependency shows its origin.

2. Use the Command Line

Run the following command in the project root to print the dependency tree: mvn dependency:tree The output lists each artifact with its scope, for example:

[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-expression:jar:6.0.9:compile
[INFO] |  \- org.springframework:spring-web:jar:6.0.9:compile
[INFO] \- org.springframework:spring-aop:jar:5.3.23:compile

If the tree is large, filter it with:

mvn dependency:tree -Dincludes=org.springframework

3. IntelliJ Plugin (Recommended)

Install the Maven Helper plugin from the IDEA marketplace. After opening pom.xml, a Dependency Analyzer tab appears, offering:

One‑click view of the dependency tree

Highlighting of conflicting JARs

Right‑click → Exclude to remove a dependency

4. Identify the Conflicting JAR

Search the tree for the same groupId + artifactId appearing with different versions, e.g.:

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

Maven selects the shortest path (nearest to the project) and omits other versions. When the selected version is not desired, manual intervention is required.

5. Resolve the Conflict

Add an exclusion to the upstream dependency in pom.xml:

<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>

If only the version differs, enforce the desired version in a dependencyManagement section:

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

6. Summary

Quickly view the dependency tree → use IDEA’s built‑in view or run mvn dependency:tree.

Efficient conflict detection → install the Maven Helper plugin for visual highlights.

Resolve conflicts → add exclusion entries or lock versions with dependencyManagement.