为什么 Maven 依赖项的顺序很重要？

Question

在之前，我认为Maven依赖的顺序并不重要，并把这视为其优点。以下是我的旧pom.xml文件中的依赖项：

<dependencies>

    <dependency>
        <groupId>org.glassfish.jersey.containers</groupId>
        <artifactId>jersey-container-servlet</artifactId>
        <version>2.19</version>
    </dependency>

    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-web</artifactId>
        <version>4.1.7.RELEASE</version>
    </dependency>

    <dependency>
        <groupId>org.glassfish.jersey.ext</groupId>
        <artifactId>jersey-spring3</artifactId>
        <version>2.19</version>
    </dependency>

    <dependency>
        <groupId>org.glassfish.jersey.media</groupId>
        <artifactId>jersey-media-moxy</artifactId>
        <version>2.19</version>
    </dependency>

</dependencies>

它的工作很好，今天我想把Spring依赖项移到底部，这样那些与Jersey相关的依赖项就可以在一起。但是，之后我无法让它继续工作，我的Jetty报错：

[ERROR] Failed to execute goal org.eclipse.jetty:jetty-maven-plugin:9.3.0.M1:run (default-cli) on project mtest: Execution default-cli of goal org.eclipse.jetty:jetty-maven-plugin:9.3.0.M1:run failed: A required class was missing while executing org.eclipse.jetty:jetty-maven-plugin:9.3.0.M1:run: org/apache/commons/logging/LogFactory

这真的很令人困惑，我需要关注依赖项的顺序吗？我怎么知道正确的顺序？

- Elderry

---

可能不能直接回答你的问题，但我通常只需声明commons-logging。在包含它后再检查一下是否仍有问题。 - Paul Samsotha

@peeskillet，我已经将它包含进去了，我的Jetty成功启动了，但是我的服务无法运行。 - Elderry

这个主题的好文章：https://dev59.com/q1oU5IYBdhLWcg3wEz-N#37854045 - user1438038

Answer 1

依赖项的顺序确实很重要，因为Maven从2.0.9版本开始解析传递依赖。以下是来自文档的摘录:

(...)这决定了在遇到一个artifact的多个版本时使用哪个版本的依赖关系。(...)你可以通过在项目的POM中明确声明版本来保证版本一致性。(...)自Maven 2.0.9以来，声明中的顺序很重要: 第一个声明获胜。

- kryger

---

我不确定为什么这个答案被投票负评。它至少在一定程度上回答了声明顺序为什么重要的问题。 - Kyle Krull

请注意，Maven首先选择与您的项目“最接近”的工件版本。只有在两个不同的版本完全相同时，它才会使用顺序来解决冲突。 - sihaya

Answer 2

为了进一步解释其他答案（其指出声明顺序影响Maven的传递依赖的依赖冲突解决），你可以使用以下几个工具：

• mvn dependency:tree [-Dscope=[runtime|test]]将显示所选范围可用的依赖项。 详情请见此处
• mvn dependency:build-classpath提供了依赖项在类路径上的可用顺序（如果两个或更多类路径条目具有相同的类，则较早的一个获胜）。 详情请见此处

我不太了解您的情况，但通常会在编译/运行时出现错误版本的一个或多个jar包。 在此处声明要使用的库的版本或使用<dependencyManagement>锁定版本是选项。

现在回答您的另一个问题-如何确定声明依赖项的正确顺序？ 我的建议-正确的声明顺序是以您想要的依赖项版本和顺序获得的顺序。 使用上述工具检查您的依赖关系，并在必要时调整声明顺序。

请注意，大多数jar文件包含命名不同的类，因此它们出现在类路径上的确切顺序通常并不重要。 我注意到唯一的例外是SLF4J中的一些jar文件，它有意地遮蔽了其他日志记录器库中的类。

- Kyle Krull