0

0

如何正确配置依赖并修复 Java XML 解析异常

碧海醫心

碧海醫心

发布时间:2026-03-01 16:31:08

|

236人浏览过

|

来源于php中文网

原创

如何正确配置依赖并修复 Java XML 解析异常

本文详解 Java 中使用 DOM 解析 XML 时常见的 db.parse() 异常原因,重点指出代码逻辑错误(如误传字符串 "is"+is)、XML 数据不合法、以及 Jakarta EE 迁移后缺失核心解析器依赖等问题,并提供可直接运行的修复方案与 Maven 配置。

本文详解 java 中使用 dom 解析 xml 时常见的 `db.parse()` 异常原因,重点指出代码逻辑错误(如误传字符串 `"is"+is`)、xml 数据不合法、以及 jakarta ee 迁移后缺失核心解析器依赖等问题,并提供可直接运行的修复方案与 maven 配置。

在 Java 中解析 XML 字符串时,看似简单的 DocumentBuilder.parse() 调用却极易因参数误用、依赖缺失或 XML 格式缺陷而失败。您提供的代码片段中,关键问题出现在第 166 行:

Document doc = db.parse("is"+is); // ❌ 错误:传入的是字符串字面量,非有效 URI 或 InputSource

该行实际向 parse() 方法传入了类似 "isorg.xml.sax.InputSource@7fc7ed31" 的字符串——这既不是合法的文件路径,也不是可解析的 XML 内容,而是 InputSource 对象的 toString() 结果。DocumentBuilder.parse(String uri) 期望的是一个 URI(如 file:///path.xml 或 https://...),而非拼接后的对象描述。正确做法是调用接受 InputSource 的重载方法:

// ✅ 正确:使用 InputSource 解析内存中的 XML 字符串
InputSource is = new InputSource(new StringReader(strXMLResponse));
Document doc = db.parse(is); // 直接传入 is 对象

此外,您的 pom.xml 存在两个关键隐患:

  1. 缺少 XML 解析核心依赖:JDK 17+ 已移除内置的 xercesImpl 和 xml-apis,且 jakarta.xml.ws-api 仅提供 Web Service 接口,不包含 XML 解析器实现。若未显式引入解析器(如 Xerces-J 或 Apache Xalan),DocumentBuilder 可能回退到空实现或抛出 UnsupportedOperationException。

    立即学习Java免费学习笔记(深入)”;

    灵枢SparkVertex
    灵枢SparkVertex

    零代码AI应用开发平台

    下载
  2. 依赖版本兼容性风险:javax.mail:mail:1.5.0-b01 属于旧版 Java EE(javax.* 命名空间),而 jakarta.xml.ws-api:4.0.0 属于 Jakarta EE 9+(jakarta.* 命名空间)。混合使用可能引发类加载冲突,尤其在 XML 相关 SPI(Service Provider Interface)注册环节。

✅ 推荐的 pom.xml 修复配置(适配 JDK 17+):

<dependencies>
    <!-- Jakarta EE 9+ 兼容的基础 XML API -->
    <dependency>
        <groupId>jakarta.xml.parsers</groupId>
        <artifactId>jakarta.xml.parsers-api</artifactId>
        <version>2.1.0</version>
    </dependency>

    <!-- 官方推荐的 XML 解析器实现(Xerces-J 的 Jakarta 分支) -->
    <dependency>
        <groupId>xerces</groupId>
        <artifactId>xercesImpl</artifactId>
        <version>2.12.2</version>
    </dependency>

    <!-- 可选:增强 SAX/DOM 功能支持 -->
    <dependency>
        <groupId>org.apache.xmlgraphics</groupId>
        <artifactId>batik-xml</artifactId>
        <version>1.17</version>
    </dependency>

    <!-- 邮件依赖建议升级为 Jakarta 版本 -->
    <dependency>
        <groupId>com.sun.mail</groupId>
        <artifactId>jakarta.mail</artifactId>
        <version>2.0.1</version>
    </dependency>

    <!-- JUnit 升级至主流版本 -->
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter</artifactId>
        <version>5.10.2</version>
        <scope>test</scope>
    </dependency>
</dependencies>

⚠️ 重要注意事项

  • 始终校验 strXMLResponse 是否为格式良好(Well-formed)的 XML:无缺失闭合标签、正确嵌套、UTF-8 编码声明一致(如 )。可借助在线工具(如 XMLValidator)快速验证。
  • 避免在生产代码中忽略异常:db.parse() 抛出 SAXException 和 IOException,务必捕获并打印完整堆栈(e.printStackTrace() 或使用日志框架),这是定位 XML 内容错误(如非法字符、编码不匹配)的唯一可靠途径。
  • 若项目已全面迁移至 Jakarta EE,确保所有 XML 相关 import 语句为 jakarta.xml.*(如 jakarta.xml.parsers.DocumentBuilderFactory),而非遗留的 javax.xml.*。

总结:修复 XML 解析失败,需“三步走”——修正 API 调用方式(传 InputSource 而非字符串)、补齐 Jakarta 兼容的解析器依赖、严格验证输入 XML 的合法性。依赖配置不是“越多越好”,而是要确保 API + Implementation + Compatibility 三位一体。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
Java Maven专题
Java Maven专题

本专题聚焦 Java 主流构建工具 Maven 的学习与应用,系统讲解项目结构、依赖管理、插件使用、生命周期与多模块项目配置。通过企业管理系统、Web 应用与微服务项目实战,帮助学员全面掌握 Maven 在 Java 项目构建与团队协作中的核心技能。

0

2025.09.15

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

890

2023.08.02

pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1936

2024.04.01

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

2114

2024.08.01

xml是什么格式的文件
xml是什么格式的文件

xml是一种纯文本格式的文件。xml指的是可扩展标记语言,标准通用标记语言的子集,是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容,可阅读本专题下面的相关文章。

1142

2024.11.28

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

658

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

219

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1560

2023.10.24

Golang 测试体系与代码质量保障:工程级可靠性建设
Golang 测试体系与代码质量保障:工程级可靠性建设

Go语言测试体系与代码质量保障聚焦于构建工程级可靠性系统。本专题深入解析Go的测试工具链(如go test)、单元测试、集成测试及端到端测试实践,结合代码覆盖率分析、静态代码扫描(如go vet)和动态分析工具,建立全链路质量监控机制。通过自动化测试框架、持续集成(CI)流水线配置及代码审查规范,实现测试用例管理、缺陷追踪与质量门禁控制,确保代码健壮性与可维护性,为高可靠性工程系统提供质量保障。

24

2026.02.28

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kotlin 教程
Kotlin 教程

共23课时 | 4万人学习

C# 教程
C# 教程

共94课时 | 10.5万人学习

Java 教程
Java 教程

共578课时 | 74.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号