java - 为什么我的 Jenkins 插件找不到我的 pom.xml 依赖项？

Question

我的 pom.xml 有这个依赖:

<dependency>
    <groupId>net.sf.json-lib</groupId>
    <artifactId>json-lib</artifactId>
    <version>2.4</version>
    <classifier>jdk15</classifier>
</dependency>

当我使用 XMLSerializer 时，它会引发异常:java.lang.NoClassDefFoundError: nu/xom/Node

如果我在本地运行该类并将 JAR 添加到我的类路径中，一切都会按预期运行。我将这个类作为 Jenkins 插件运行，所以我不希望手动定义类路径 - 我认为这就是 Maven 应该处理的。

请务必注意，Jenkins 插件需要我上传从 Maven 创建的 hpi 文件。它没有根据输出 jar 运行。如果我继续使用 Jenkins 框并手动将 xom JAR 放入 WEB-INF/libs，它就可以工作。但显然这意味着这个插件不适合其他人，这是弄巧成拙的。

这是导致错误的最少代码:https://github.com/DaveStein/parser-sample

自述文件有准确的复制步骤。

关于所选答案的说明我的示例 repo 的 PR 让我大部分时间到达了我需要的地方。我确实有一些其他问题需要解决，但 JSONObject 冲突是核心问题。我按照 Jesse 的 PR 建议取出了所有 GlobalConfiguration。唯一可能与 future 查看器有关的其他问题是在使用 xom 作为显式依赖项同时还为 org.jenkins-ci.plugins 使用高于 1.626 的版本时出现一些故障这篇文章的时间。

Answer 1

Jenkins 核心捆绑 json-lib。 (一个 fork 的副本，对于这个问题来说并不重要。)它确实 not 捆绑了可选的依赖项¹ XOM，不管是什么。当您的插件加载 XmlSerializer.class 时，它由 Jenkins 核心的类加载器定义，然后尝试链接到诸如 nu.xom.Node 之类的类。因为这在 XmlSerializer 的定义加载器中不可用——Jenkins 核心类加载器(或多或少是 jenkins.war!/WEB-INF/lib/*.jar) ——你得到一个错误。在您的插件类加载器中可以访问名为 的类这一事实并不重要，请原谅双关语。

如果您的插件需要使用自己的类版本，这些版本通常捆绑在 Jenkins 核心中并隐式暴露给插件，那么它不仅需要捆绑这些 JAR(常规的 compile 范围的 Maven依赖就足够了)，但也可以使用 pluginFirstClassLoader option .在尝试这样做之前，您最好彻底了解 Java 类加载语义，否则您将迷失在神秘的² ClassCastExceptions 和 LinkageErrors 的迷宫中。

顺便说一句，通常用于迭代测试插件代码的 mvn hpi:run 命令确实不模拟了现实的类加载机制。因此，如果您在此空间中使用 pluginFirstClassLoader 或任何其他技巧，请始终通过在示例中(重新)安装 *.hpi 来仔细检查生成的类加载行为Jenkins 实例，例如使用 /pluginManager/advanced 或 install-plugin CLI 命令。从您的描述来看，您已经在这样做了(并且可能不知道 hpi:run)。

¹这里的原罪是使用 optional 依赖项。 json-lib 应该定义一个独特的 Artifact json-lib-xom 硬依赖于 json-lib 和 xom。这将确保任何给定的类加载器都可以看到 XmlSerializer 和 它的依赖项，或者两者都看不到。

²JDK-6273389 上没有进展，唉。标记为重复，但它是什么重复，我不确定。从理论上讲，Java 9 模块通过施加如此繁重的限制使得像 Jenkins 这样的应用程序一开始就无法使用该模块系统，从而使此类问题变得过时。