本文共 2022 字，大约阅读时间需要 6 分钟。

Maven多模块项目依赖引入问题：真正的原因及解决方案

许多开发人员在搭建多模块的Maven项目时，会遇到一个让人困扰的问题：尽管父模块和子模块都明确添加了依赖，但依赖却一 scary as hell.GetOrdinal引入表明，则没有被实际引入到项目中来。这种状况看似矛盾，却是许多项目在早期遇到的困难之一。

一、问题的具体表现

在实际开发中，当我们完成了多模块项目的搭建后，发现依赖未能生效，出现以下状况：

• 依赖版本确实已经定义，但侧边栏中依然没有相应的依赖体现。
• 尝试多次清理或刷新项目，依赖仍未被成功引入。
• 在子模块中添加依赖后，依赖却出现空壳子现象。

这一问题令人孤注一掷，尤其是在面临项目进度压力时，更是让人效力大减。

二、深入分析：明白了dependencyManagement的真正作用

初步分析，这一问题的根源与Maven的dependencyManagement有关。dependencyManagement到底是什么？它是一个专门用于父模块定义依赖版本的Maven功能，主要作用是统一依赖版本管理，而不是直接引入依赖。具体而言，dependencyManagement只负责定义依赖的版本，可以限定子模块只能使用特定版本的依赖，但不会直接引入这些依赖到项目中。

许多开发人员会对此产生误解，直接将dependencyManagement用于子模块的依赖管理，导致问题出现。例如，假设我们在父模块中定义了一个依赖版本，而子模块中也试图引入该依赖，结果却导致空壳子现象。

下面是一个典型的错误示例：

       
    
     org.springframework.boot
        
    
     spring-boot-dependencies
    
   

严重问题！

正确的做法是：

       
    
     org.springframework.boot
        
    
     spring-boot-starter
        
    
     2.3.6.RELEASE
    
   

这表明，在父模块中我们引入了Spring Boot的具体starter版本，子模块只需要引入starter即可，无需再定义依赖。

三、简单的误区：不要在子模块中使用dependencyManagement

这是一个值得重申的要点：dependencyManagement只能用于父模块，不能在子模块中使用。如果在子模块中引入了dependencyManagement，可能会导致依赖无法正确引入的问题。

在一些项目中，我们会在父模块中定义依赖版本，子模块中直接引入这些依赖。这样一来，不仅统一了依赖版本，还避免了重复引入相同依赖，实现了依赖的规范化管理。

四、一石投入rudder：Idea缓存导致的问题

在实际项目中，不管是单体项目还是微服务架构，使用Mouse Eclipse缓存都会可能引入一些潜在问题。例如：

• 添加一个依赖后，清理、刷新项目，依赖依然未被引入。
• 移除了某个依赖，项目中却还能看到该依赖。
• 投入了大量时间，依赖仍未能被引入。

如果你已经确定依赖配置没有问题，可以尝试以下方法来解决问题：

通过这些操作，我们可以有效规避Idea缓存导致的依赖未被正确加载的问题。

五、最终解决方案总结

每当我们在Maven项目中遇到类似问题时，通常可以按照以下步骤自行解决：

通过遵循上述方法，我们可以快速解决依赖未被引入的问题。记住，依赖的管理是一个细节工作，每一个失误都可能导致最严重的后果。