777

在我的办公室里，仅仅提到 Xerces 这个词就足以激起开发人员的杀气。粗略浏览一下关于 SO 的其他 Xerces 问题似乎表明几乎所有 Maven 用户在某个时候都被这个问题“触动”了。不幸的是，理解这个问题需要对 Xerces 的历史有一点了解......

历史

  • Xerces 是 Java 生态系统中使用最广泛的 XML 解析器。几乎每个用 Java 编写的库或框架都以某种方式使用 Xerces（如果不是直接传递，也可以传递）。

  • 直到今天，官方二进制文件中包含的 Xerces jar 还没有版本控制。例如，Xerces 2.11.0 实现 jar 名为xercesImpl.jar而不是xercesImpl-2.11.0.jar.

  • Xerces 团队不使用 Maven，这意味着他们不会将正式版本上传到Maven Central。

  • Xerces 曾经作为单个 jar ( xerces.jar) 发布，但被拆分为两个 jar，一个包含 API ( xml-apis.jar)，另一个包含这些 API 的实现 ( xercesImpl.jar)。许多较旧的 Maven POM 仍然声明对xerces.jar. 在过去的某个时候，Xerces 也以 . 的形式发布xmlParserAPIs.jar，一些较旧的 POM 也依赖于它。

  • 那些将 jar 部署到 Maven 存储库的人分配给 xml-apis 和 xercesImpl jar 的版本通常是不同的。例如，xml-apis 可能被赋予 1.3.03 版本，而 xercesImpl 可能被赋予 2.8.0 版本，即使两者都来自 Xerces 2.8.0。这是因为人们经常用它实现的规范版本来标记 xml-apis jar。这里有一个非常好的但不完整的细分。

  • 更复杂的是，Xerces 是用于 Java API for XML Processing (JAXP) 的参考实现中的 XML 解析器，包含在 JRE 中。实现类在com.sun.*命名空间下重新打包，这使得直接访问它们很危险，因为它们在某些 JRE 中可能不可用。但是，并非所有 Xerces 功能都通过java.*和javax.*API 公开；例如，没有公开 Xerces 序列化的 API。

  • 更令人困惑的是，几乎所有的 servlet 容器（JBoss、Jetty、Glassfish、Tomcat 等）都在其一个或多个/lib文件夹中附带了 Xerces。

问题

解决冲突

由于上述某些（或全部）原因，许多组织在其 POM 中发布和使用 Xerces 的自定义构建。如果您有一个小型应用程序并且只使用 Maven Central，这并不是一个真正的问题，但它很快成为 Artifactory 或 Nexus 代理多个存储库（JBoss、Hibernate 等）的企业软件的问题：

由 Artifactory 代理的 xml-apis

例如，组织 A 可能发布xml-apis为：

<groupId>org.apache.xerces</groupId>
<artifactId>xml-apis</artifactId>
<version>2.9.1</version>

同时，组织 B 可能会发布与以下内容相同jar的内容：

<groupId>xml-apis</groupId>
<artifactId>xml-apis</artifactId>
<version>1.3.04</version>

虽然 B 的jar版本比 A 的版本低jar，但 Maven 并不知道它们是同一个工件，因为它们 groupId的 s 不同。因此，它无法执行冲突解决，并且两个 jars 都将被包含为已解决的依赖项：

使用多个 xml-api 解决依赖关系

类加载器地狱

如上所述，JRE 在 JAXP RI 中随 Xerces 一起提供。虽然最好将所有 Xerces Maven 依赖项标记为<exclusion>s 或<provided>，您所依赖的第三方代码可能与您正在使用的 JDK 的 JAXP 中提供的版本一起工作，也可能不工作。此外，您可以在 servlet 容器中提供 Xerces jar 以应对。这给您留下了许多选择：您是否删除了 servlet 版本并希望您的容器在 JAXP 版本上运行？离开 servlet 版本是否更好，并希望您的应用程序框架在 servlet 版本上运行？如果上面列出的一两个未解决的冲突设法溜进您的产品（在大型组织中很容易发生），您很快就会发现自己陷入了类加载器的地狱，想知道类加载器在运行时选择了哪个版本的 Xerces 以及它是否将在 Windows 和 Linux 中选择相同的 jar（可能不会）。

解决方案？

我们已经尝试将所有 Xerces Maven 依赖项标记为<provided>或，但鉴于工件具有如此多的别名（ 、、、等）<exclusion>，这很难实施（尤其是对于大型团队）。此外，我们的第三方库/框架可能无法在 JAXP 版本或 servlet 容器提供的版本上运行。xml-apisxercesxercesImplxmlParserAPIs

我们如何用 Maven 最好地解决这个问题？我们是否必须对依赖项进行如此细粒度的控制，然后依赖分层类加载？是否有某种方法可以全局排除所有 Xerces 依赖项，并强制我们所有的框架/库使用 JAXP 版本？

更新：Joshua Spiewak 已将 Xerces 构建脚本的补丁版本上传到XERCESJ-1454，允许上传到 Maven Central。投票/观看/为这个问题做出贡献，让我们一劳永逸地解决这个问题。

4

11 回答 11

119

自 2013 年 2 月 20 日以来，Maven Central 中有 Xerces的 2.11.0 JAR （和源 JAR！） ！请参阅Maven Central 中的 Xerces。我想知道他们为什么没有解决https://issues.apache.org/jira/browse/XERCESJ-1454 ...

我用过：

<dependency>
    <groupId>xerces</groupId>
    <artifactId>xercesImpl</artifactId>
    <version>2.11.0</version>
</dependency>

并且所有依赖项都已解决 - 甚至是正确的xml-apis-1.4.01！

最重要的是（过去并不明显）——Maven Central 中的 JAR 与官方Xerces-J-bin.2.11.0.zip发行版中的 JAR 相同。

但是我找不到版本 -由于附加依赖关系，xml-schema-1.1-beta它不能是 Maven版本。classifier

于 2013-03-07T07:30:21.040 回答
66

坦率地说，我们遇到的几乎所有东西都可以在 JAXP 版本中正常工作，所以我们总是排除 xml-apis和xercesImpl.

于 2012-07-26T22:18:36.327 回答
44

您可以将 Maven 强制插件与禁止依赖规则一起使用。这将允许您禁止所有您不想要的别名，而只允许您想要的别名。违反这些规则时，您的项目的 Maven 构建将失败。此外，如果此规则适用于企业中的所有项目，您可以将插件配置放在企业父 pom.xml 中。

看：

于 2012-07-27T16:28:38.507 回答
37

我知道这并不能完全回答这个问题，但是对于来自谷歌的 ppl 碰巧使用 Gradle 进行依赖管理：

我设法摆脱了 Gradle 的所有 xerces/Java8 问题，如下所示：

configurations {
    all*.exclude group: 'xml-apis'
    all*.exclude group: 'xerces'
}
于 2015-04-24T06:54:38.963 回答
16

我想你需要回答一个问题：

是否存在您应用程序中的所有内容都可以使用的 xerces*.jar？

如果不是这样，你基本上就完蛋了，不得不使用 OSGI 之类的东西，它允许你同时加载不同版本的库。请注意，它基本上用类加载器问题替换了 jar 版本问题......

如果存在这样的版本，您可以让您的存储库为所有类型的依赖项返回该版本。这是一个丑陋的 hack，最终会在你的类路径中多次使用相同的 xerces 实现，但比拥有多个不同版本的 xerces 更好。

您可以将每个依赖项排除在 xerces 中，并将一个添加到您要使用的版本中。

我想知道您是否可以编写某种版本解析策略作为 maven 的插件。这可能是最好的解决方案，但如果可行的话需要一些研究和编码。

对于运行时环境中包含的版本，您必须确保将其从应用程序类路径中删除，或者在考虑服务器的 lib 文件夹之前首先考虑应用程序 jar 以进行类加载。

所以总结一下：这是一团糟，不会改变。

于 2012-07-26T20:49:39.367 回答
9

您应该首先进行调试，以帮助确定您的 XML 地狱级别。在我看来，第一步是添加

-Djavax.xml.parsers.SAXParserFactory=com.sun.org.apache.xerces.internal.jaxp.SAXParserFactoryImpl
-Djavax.xml.transform.TransformerFactory=com.sun.org.apache.xalan.internal.xsltc.trax.TransformerFactoryImpl
-Djavax.xml.parsers.DocumentBuilderFactory=com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderFactoryImpl

到命令行。如果可行，则开始排除库。如果没有，那么添加

-Djaxp.debug=1

到命令行。

于 2016-06-14T13:51:53.637 回答
8

这里还没有探讨另一个选项：在 Maven 中将 Xerces 依赖项声明为可选：

<dependency>
   <groupId>xerces</groupId>
   <artifactId>xercesImpl</artifactId>
   <version>...</version>
   <optional>true</optional>
</dependency>

基本上，这样做是强制所有依赖项声明他们的 Xerces 版本，否则他们的项目将无法编译。如果他们想覆盖这种依赖关系，欢迎他们这样做，但是他们将拥有潜在的问题。

这为下游项目创造了强大的动力：

  • 做出积极的决定。他们是使用相同版本的 Xerces 还是使用其他东西？
  • 实际测试他们的解析（例如通过单元测试）和类加载，以及不要弄乱他们的类路径。

并非所有开发人员都跟踪新引入的依赖项（例如 with mvn dependency:tree）。这种做法会立即引起他们的注意。

它在我们的组织中运行良好。在介绍之前，我们曾经生活在 OP 所描述的同一个地狱中。

于 2015-10-02T09:52:51.990 回答
6

每个 maven 项目都应该停止依赖于 xerces，他们可能不会。XML API 和 Impl 自 1.4 以来一直是 Java 的一部分。无需依赖 xerces 或 XML API，就像说您依赖 Java 或 Swing。这是隐含的。

如果我是一个 maven repo 的老板，我会编写一个脚本来递归地删除 xerces 依赖项并写一个读我说这个 repo 需要 Java 1.4。

任何由于通过 org.apache 导入直接引用 Xerces 而实际中断的东西都需要代码修复以将其提升到 Java 1.4 级别（并且自 2002 年以来已经完成）或通过认可的库而不是 maven 在 JVM 级别的解决方案。

于 2016-02-05T11:58:43.507 回答
2

除了排除之外，什么会有所帮助的是模块化依赖关系。

对于一个平面类加载（独立应用程序）或半分层（JBoss AS/EAP 5.x），这是一个问题。

但是对于像OSGi和JBoss Modules这样的模块化框架，这不再那么痛苦了。这些库可以独立地使用他们想要的任何库。

当然，仍然最推荐只使用一个实现和版本，但如果没有其他方法（使用更多库中的额外功能），那么模块化可能会节省您的时间。

JBoss 模块的一个很好的例子自然是JBoss AS 7 / EAP 6 / WildFly 8，它主要是为此开发的。

示例模块定义：

<?xml version="1.0" encoding="UTF-8"?>
<module xmlns="urn:jboss:module:1.1" name="org.jboss.msc">
    <main-class name="org.jboss.msc.Version"/>
    <properties>
        <property name="my.property" value="foo"/>
    </properties>
    <resources>
        <resource-root path="jboss-msc-1.0.1.GA.jar"/>
    </resources>
    <dependencies>
        <module name="javax.api"/>
        <module name="org.jboss.logging"/>
        <module name="org.jboss.modules"/>
        <!-- Optional deps -->
        <module name="javax.inject.api" optional="true"/>
        <module name="org.jboss.threads" optional="true"/>
    </dependencies>
</module>

与 OSGi 相比，JBoss 模块更简单、更快。虽然缺少某些功能，但对于大多数（大部分）由一个供应商控制的项目来说已经足够了，并且允许惊人的快速启动（由于并行依赖解决）。

请注意，Java 8 正在进行模块化工作，但 AFAIK 主要是为了模块化 JRE 本身，不确定它是否适用于应用程序。

于 2013-06-22T02:59:50.853 回答
2

我的朋友这很简单，这里举个例子：

<dependency>
    <groupId>xalan</groupId>
    <artifactId>xalan</artifactId>
    <version>2.7.2</version>
    <scope>${my-scope}</scope>
    <exclusions>
        <exclusion>
        <groupId>xml-apis</groupId>
        <artifactId>xml-apis</artifactId>
    </exclusion>
</dependency>

如果您想在终端（此示例的 Windows 控制台）中检查您的 Maven 树是否没有问题：

mvn dependency:tree -Dverbose | grep --color=always '(.* conflict\|^' | less -r
于 2017-05-18T14:08:24.733 回答
2

显然xerces:xml-apis:1.4.01不再在 Maven 中心，但这就是xerces:xercesImpl:2.11.0参考。

这对我有用：

<dependency>
  <groupId>xerces</groupId>
  <artifactId>xercesImpl</artifactId>
  <version>2.11.0</version>
  <exclusions>
    <exclusion>
      <groupId>xerces</groupId>
      <artifactId>xml-apis</artifactId>
    </exclusion>
  </exclusions>
</dependency>
<dependency>
  <groupId>xml-apis</groupId>
  <artifactId>xml-apis</artifactId>
  <version>1.4.01</version>
</dependency>
于 2016-10-04T16:45:02.570 回答