Cannot resolve symbol ‘XXX‘ Maven 依赖问题的解决过程

一、问题描述

在使用 Maven 管理项目依赖时，遇到了一个棘手的问题。具体表现为：在 pom.xml 文件中导入了所需的依赖，并且在 IDE 中导入语句没有显示为红色（表示 IDE 没有提示依赖缺失），但是在实际使用这些依赖的代码中，却显示该依赖不存在。尝试了多种常规的解决办法，例如使用 mvn clean install 命令重新构建项目、在 IDE 中刷新 Maven 项目（如在 IntelliJ IDEA 中点击 Reload All Maven Projects 按钮，在 Eclipse 中右键点击项目选择 Maven -> Update Project），检查依赖的版本号和导入语句是否正确等，都未能解决问题。

二、最终解决办法

经过一番探索，发现当 pom.xml 中使用了 <dependencyManagement> 元素管理依赖时，出现了问题。虽然不会爆红且源中存在所需的依赖，但本地仓库中无法正确找到该依赖。最终采取的解决办法是：将最外围的 <dependencyManagement></dependencyManagement> 标签去掉，然后刷新项目。这样做之后，问题得到解决，依赖能够正常找到和下载。

build后没有报Cannot resolve symbol 'baomidou' Maven 的错误了。之前我的这个依赖在dependencyManagement中。

三、dependencyManagement 和 dependencies 的区别

dependencies 元素：

• 功能：用于声明项目直接依赖的库。这些依赖是项目运行或构建所必需的，会被添加到项目的类路径中。
• 特点：

  • 直接在 dependencies 中添加的依赖会自动被引入到项目中 ，并且可以指定依赖的范围（如 compile、test、runtime 等）。

  • 当多个子模块继承父模块时，父模块 dependencies 中的依赖会自动传递给子模块，子模块可以直接使用。

  • 示例：

    org.springframework.boot spring-boot-starter-web 2.7.6

dependencyManagement 元素：

• 功能：主要用于集中管理依赖的版本，不会直接引入依赖，而是在子模块或其他依赖该项目的项目中，当需要引入依赖时，根据 dependencyManagement 中指定的版本信息进行统一管理，避免版本冲突。
• 特点：

  • 通常在父模块中使用，通过 <dependencyManagement> 声明依赖的版本信息，但不会自动添加这些依赖到项目中。

  • 子模块或其他项目可以通过添加 <dependency> 元素（仅指定 groupId 和 artifactId）来引入这些依赖，会自动使用 dependencyManagement 中定义的版本，这样可以确保多个模块使用相同的依赖版本。

    org.springframework.boot spring-boot-dependencies 2.7.6 pom import