Maven使用parent管理依赖的一个坑

在使用maven parent管理依赖的多module项目中，有时候编译没问题，但是运行起来就会报java.lang.NoSuchMethodError:，或者在编译的时候报java: 找不到符号。

项目中，为了模块清晰，方便依赖管理和版本维护，一般会使用一个parent module进行依赖的统一管理，规范依赖版本，集中管理项目属性。

项目里一般会有很多二方包，为了方便管理，我们也把版本号统一在了parent里面，然后在项目里面引用的时候再覆盖版本号。举个例子，我们有三个module app1～3，他们都继承parent module的依赖管理。如

// parent dependencyManagement 指定app1～3的版本都是0.0.1

parent<--app1:0.0.2 //相比0.0.1版本App1Req类新增方法getGreet
            ^
            |
parent<--app2:0.0.2 //方法getGreeting调用方法getGreet
            ^
            |
parent<--app3:0.0.1 //调用getGreeting，执行时候报java.lang.NoSuchMethodError: 'App1Req.getGreet()'

这样的管理方式从表面看毫无问题，毕竟app2已经指定依赖app1:0.0.2，按理说app3依赖app2:0.0.2也会包含有app1:0.0.2，但实际上parent会覆盖本module非直接引用的库版本。从优先级上来看直接引用最高，其次是parent，然后才到依赖引入的依赖：

dependencies > parent.dependencyManagement > dependencies.item.dependencies

如图

image-fail.png

解决办法是在parent内部不要指定二方库的版本号，因为二方库变动频繁，版本号迭代迅速，理论上二方库的内部依赖应该是对调用方透明的。而三方库版本号在parent内部管理是为了防止一些依赖的冲突，方便统一整个项目的依赖。甚至可以在公司内部维护一个parent。

修复后依赖如下：

image-success.png

下面是有问题的pom供参考。修复问题将parent.xml内dependencyManagement的app1～3依赖项删除即可

parent/pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>org.example</groupId>
    <artifactId>parent</artifactId>
    <version>1.0-SNAPSHOT</version>
    <modules>
        <module>../app1</module>
        <module>../app2</module>
        <module>../app3</module>
    </modules>
    <packaging>pom</packaging>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.4.1</version>
    </parent>

    <properties>
        <maven.compiler.source>15</maven.compiler.source>
        <maven.compiler.target>15</maven.compiler.target>
        <maven.test.skip>true</maven.test.skip>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <slf4j-api.version>1.7.25</slf4j-api.version>
        <app1.version>0.0.1</app1.version>
        <app2.version>0.0.1</app2.version>
        <app3.version>0.0.1</app3.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
        </dependency>
    </dependencies>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.slf4j</groupId>
                <artifactId>slf4j-api</artifactId>
                <version>${slf4j-api.version}</version>
            </dependency>
            <dependency>
                <groupId>org.example</groupId>
                <artifactId>app1</artifactId>
                <version>${app1.version}</version>
            </dependency>
            <dependency>
                <groupId>org.example</groupId>
                <artifactId>app2</artifactId>
                <version>${app2.version}</version>
            </dependency>
            <dependency>
                <groupId>org.example</groupId>
                <artifactId>app3</artifactId>
                <version>${app3.version}</version>
            </dependency>
        </dependencies>
    </dependencyManagement>

</project>

app1/pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <artifactId>parent</artifactId>
        <groupId>org.example</groupId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>app1</artifactId>
    <version>0.0.2</version>

</project>

app2/pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <artifactId>parent</artifactId>
        <groupId>org.example</groupId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>app2</artifactId>
    <version>0.0.2</version>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.example</groupId>
            <artifactId>app1</artifactId>
            <version>0.0.2</version>
        </dependency>
    </dependencies>

</project>

app3/pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <artifactId>parent</artifactId>
        <groupId>org.example</groupId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>app3</artifactId>
    <version>0.0.1</version>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.example</groupId>
            <artifactId>app2</artifactId>
            <version>0.0.2</version>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>