Java 项目中 Xerces 依赖解析失败的根源与标准修复方案

酷明大大_1274

酷明大大_1274

2026-10-16

196人浏览

原创

Java 项目中 Xerces 依赖解析失败的根源与标准修复方案

Maven 无法解析 org.apache.xerces:org.apache.xerces:2.12.2 是因坐标错误——该 artifact 并不存在于 Maven 中央仓库;正确依赖应为 xerces:xercesImpl(API 层则用 xml-apis:xml-apis),且需注意 JDK 版本适配与命名空间迁移。

maven 无法解析 `org.apache.xerces:org.apache.xerces:2.12.2` 是因坐标错误——该 artifact 并不存在于 maven 中央仓库;正确依赖应为 `xerces:xercesimpl`(api 层则用 `xml-apis:xml-apis`),且需注意 jdk 版本适配与命名空间迁移。

Xerces 是 Java 生态中历史悠久的 XML 解析器实现,但其 Maven 发布历史混乱、坐标不统一,是开发者高频踩坑点。你当前 pom.xml 中声明的:

<dependency><groupid>org.apache.xerces</groupid><artifactid>org.apache.xerces</artifactid><version>2.12.2</version></dependency>

完全无效——Maven 中央仓库(https://repo.maven.apache.org/maven2)中根本不存在 org.apache.xerces:org.apache.xerces 这一 artifact。该坐标既非官方发布格式,也未被 Apache 官方维护。你看到的 2.12.2 版本仅零星出现在第三方小众仓库(如 Clazzes),不具备可靠性和可持续性。

✅ 正确的、被广泛支持的 Xerces 核心依赖坐标如下:

用途 groupId artifactId 推荐版本(截至 2026) 说明
XML 解析器实现 xerces xercesImpl 2.12.2 提供 org.apache.xerces.parsers.DOMParser 等核心类
XML 标准 API 接口 xml-apis xml-apis 2.0.2 或 1.4.01 定义 org.w3c.dom.*、org.xml.sax.* 等接口(JDK 已内置部分)

⚠️ 注意:自 JDK 9 起,xml-apis 的多数接口已由 java.xml 模块提供;JDK 17+ 更彻底移除了对 javax.xml.* 的默认绑定,必须显式引入 xercesImpl 才能保障 DOM/SAX 解析功能完整可用。

✅ 修复后的最小可行 pom.xml 片段

<dependencies><!-- JUnit 测试(保持不变) --><dependency><groupid>junit</groupid><artifactid>junit</artifactid><version>4.13.2</version><scope>test</scope></dependency><!-- ✅ 正确的 Xerces 实现依赖 --><dependency><groupid>xerces</groupid><artifactid>xercesImpl</artifactid><version>2.12.2</version></dependency><!-- ✅ 可选:显式声明 XML API(增强兼容性,尤其在老 JDK 或容器环境中) --><dependency><groupid>xml-apis</groupid><artifactid>xml-apis</artifactid><version>2.0.2</version></dependency></dependencies>

? 验证与注意事项

  • 无需额外配置仓库:xerces:xercesImpl 和 xml-apis:xml-apis 均已同步至 Maven 中央仓库,开箱即用。
  • 避免冲突:若项目中其他依赖(如旧版 Spring、Struts、WebLogic 客户端)间接引入了不同版本的 xercesImpl,请使用 <exclusions></exclusions> 显式排除,再统一声明所需版本:
    <dependency><groupid>some.group</groupid><artifactid>legacy-lib</artifactid><version>1.0</version><exclusions><exclusion><groupid>xerces</groupid><artifactid>xercesImpl</artifactid></exclusion></exclusions></dependency>
  • JDK 17+ 专项提醒:
    若你使用 JDK 17 或更高版本,且代码中调用 DocumentBuilder.parse(new InputSource(...)) 仍报 ClassNotFoundException 或 SAXException,请确认:
    1. 未误用 javax.xml.* 包(JDK 17+ 已迁移到 jakarta.xml.*,但 Xerces 本身仍属 org.apache.xerces,与 Jakarta 迁移无关);
    2. 未因 Servlet 容器(如 Tomcat 10+)自带 Jakarta EE 实现而引发类加载冲突——此时应将 xercesImpl 设为 <scope>provided</scope>,交由容器提供。

? 总结

Xerces 不是“不能用”,而是“不能乱用”。其 Maven 坐标长期存在 xerces:xercesImpl(主流)、org.apache.xerces:xercesImpl(极少维护)、org.apache.xerces:org.apache.xerces(完全错误)等多套并行体系。坚持使用 xerces:xercesImpl + xml-apis:xml-apis 这一经过数十年验证的组合,配合 mvn dependency:tree -Dverbose 审查传递依赖,即可彻底规避“Could not resolve dependencies for org.apache.xerces”类错误。真正的稳定,始于坐标的精准。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

java

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

10497

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

7622

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

6652

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1144

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

928

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1376

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2769

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20071

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1235

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习