聚合项目中部分Maven依赖不传递的问题分析及解决

智_永无止境

已于 2025-03-12 16:35:39 修改

阅读量1.1k

点赞数 18

文章标签： maven java 开发语言

于 2025-02-26 09:30:56 首次发布

本文链接：https://blog.youkuaiyun.com/static_coder/article/details/145869550

版权

01 引言

    在复杂的聚合项目开发中，Maven依赖管理如同一把双刃剑。虽能简化模块协作，却也暗藏"依赖传递丢失"的隐形陷阱。

    开发者常陷入这样的困境：明明依赖树完整无误，代码编译成功，却在运行时因缺少某个底层库而崩溃；单元测试顺利通过，生产环境却因`ClassNotFoundException`意外宕机。更令人头疼的是，这类问题往往潜伏在聚合项目的依赖迷宫中，由版本覆盖、隐式排除或父子POM配置冲突悄然触发。

    当项目规模膨胀、团队协作加深，依赖链的断裂可能像多米诺骨牌般引发连锁反应，导致调试成本飙升，甚至威胁交付周期。本文将深入剖析Maven依赖传递失效的典型场景，揭示其背后的"元凶"，并为你提供一套从预防到修复的全链路解决方案，助你摆脱依赖黑洞，重掌项目构建的主动权。

02 案例项目

先看项目的目录结构：

|-- maven-denpendency

|-- maven-common

|-- maven-dedc-parent

|-- maven-A

|-- maven-B

如图：
在这里插入图片描述

2.1 父级pom管理的依赖

maven-denpendency 中主要的管理的maven依赖，其他省略

 <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>com.dtflys.forest</groupId>
                <artifactId>forest-spring-boot-starter</artifactId>
                <version>${forest.version}</version>
            </dependency>
            <dependency>
                <groupId>com.simonking</groupId>
                <artifactId>maven-common</artifactId>
                <version>${maven-common.version}</version>
            </dependency>
            <dependency>
                <groupId>com.google.guava</groupId>
                <artifactId>guava