java的xml转json：从解析到输出的完整教程
在Java项目中，经常需要把配置文件、接口响应或遗留系统输出的XML数据转换成JSON，以便前端渲染、存入文档数据库或对接现代API。直接手工改写容易出错，用代码自动转换更可靠。本文面向需要处理这类转换的开发者，从零开始梳理在Java中完成XML转JSON的完整思路和操作步骤，同时说明容易踩坑的地方。
在线工具XML转JSON
准备工作：明确转换目标与依赖
动手之前先想清楚两件事：XML的结构是否固定，以及JSON的输出形态希望是什么样。XML允许属性、文本、子节点混排，而JSON只有对象、数组和值，因此必须提前决定属性怎么表示、重复节点是否转为数组、纯文本节点用什么键名承载。
依赖方面，常见选择有两类。一类是JDK自带的DOM或StAX解析器，配合手写遍历逻辑，不引入额外依赖；另一类是第三方库，例如Jackson的XML扩展、org.json等，能减少样板代码。如果项目已经使用Jackson处理JSON，引入其XML数据格式模块通常最省事。
准备一份结构有代表性的XML样本，包含属性、嵌套节点和重复节点，用它来验证转换结果是否符合预期。
分步操作：解析XML并构建JSON
第一步，把XML读入内存。使用DocumentBuilderFactory创建DocumentBuilder，解析文件或字符串得到Document对象。注意关闭外部实体加载，避免解析不受信任的XML时引入安全风险。
第二步，从根节点开始递归遍历。对每个元素，先处理它的属性，把属性名作为键写入当前JSON对象；再遍历子节点，遇到元素节点就递归，遇到文本节点且内容非空白，则作为当前节点的值或放入约定的文本键中。
第三步，处理重复节点。同一个父节点下出现多个同名子元素时，不能简单覆盖，应把它们收集成JSON数组。判断逻辑可以放在遍历过程中：先记录已出现的键，再次遇到同名键时把值升级为数组。
第四步，输出JSON。用JSON库的序列化方法把构建好的对象写成字符串，注意设置缩进以便阅读，并确保特殊字符被正确转义。
如果不想在本地写完整代码，也可以先用在线工具验证XML结构对应的JSON形态，例如通过XML转JSON工具快速查看转换结果，再据此调整自己的映射规则。
常见错误与排查
转换结果里属性丢失，通常是因为遍历时只处理了子元素，没有读取Attributes集合。检查代码中是否对每个元素调用了获取属性的方法。
数组和对象混淆，多出现在只有一个同名子节点的场景。如果规则是“同名即数组”，需要保证即使只有一个节点也输出数组，否则前后端解析逻辑会不一致。
文本内容被空白字符污染，是因为XML格式化产生的换行和缩进也被当成了文本节点。遍历时对文本做去空白判断，忽略空字符串。
遇到命名空间时，元素名可能带有前缀，直接用作JSON键会显得杂乱。可以在解析时统一去掉前缀，或把命名空间URI作为单独的元数据保留。
解析大文件时出现内存压力，说明一次性加载整棵树不合适，可改用流式解析，边读边构建JSON。
进阶技巧：让转换更可控
把映射规则抽成配置。例如用一张表定义哪些元素转数组、哪些属性提升为字段、哪些节点忽略。这样面对不同来源的XML时，不必反复改代码。
对混合内容做归一化。当元素既有文本又有子元素时，可以约定一个固定的文本键名，把散落的文本集中存放，避免JSON结构随输入波动。
为转换结果写单元测试。准备若干份典型XML样本，断言输出JSON的关键字段和数组长度，防止后续修改破坏已有行为。
如果转换是服务的一部分，考虑把解析和序列化分离成独立方法，便于替换底层库，也方便在出错时定位是解析阶段还是输出阶段的问题。
总结
在Java中完成XML转JSON，核心是先用DOM或流式解析器读取XML，再递归遍历节点，按约定把属性、文本和重复节点映射到JSON结构，最后序列化输出。准备阶段要确定映射规则，操作中注意数组判断和空白处理，排查时重点关注属性丢失、数组形态和命名空间问题。把规则配置化并补充测试，能让转换在项目里长期稳定运行。
相关文章
- cjson转xml字符串怎么做才不踩坑
从字段类型、数组表示到根节点约定，说明把 cJSON 数据转成 XML 字符串时容易出错的地方，并给出可操作的检查思路。
- cjson转xmlcdata：CDATA在数据转换中的角色
探讨cjson转xmlcdata时CDATA的用途与处理方式，帮助开发者在JSON与XML转换中正确处理特殊字符和富文本内容。
- cjson转xml：从JSON结构到XML文档的映射思路
聊聊cjson转xml时字段名、数组、属性与命名空间的对应方式，以及转换后校验结构完整性的思路。
- cjson转cdataxml：处理特殊字符的转换思路
当JSON数据需要嵌入XML时，cjson转cdataxml能避免特殊字符冲突。本文解释其含义、适用场景与操作要点。
- cjson文件转xml文件怎么打开？先理清转换与打开的关系
遇到cjson文件转xml文件怎么打开的问题？本文教你识别cjson文件、选择转换方式、用合适工具查看XML结果，并排查常见错误。
常见问题
Q1XML里的属性应该怎么放进JSON？
常见做法有两种：一是把属性平铺到当前对象的键中，与子元素同级；二是单独用一个属性对象存放，避免与子元素键名冲突。选择哪种取决于下游对JSON的消费方式，建议提前约定并保持一致。
Q2为什么转换后数组变成了对象？
多数JSON库在序列化时，如果集合只有一个元素，可能仍输出为数组，但手写逻辑容易在“首次遇到同名节点”时直接赋值而非建数组。检查重复节点的判断逻辑，确保同名节点始终按数组处理。
Q3解析XML时提示实体引用错误怎么办？
这通常与DTD或外部实体有关。可以禁用外部实体加载和DTD处理，既能避免安全风险，也能绕开因网络不可达导致的解析失败。具体开关在DocumentBuilderFactory上设置。
Q4转换后的JSON中文变成乱码怎么处理？
确认读取XML时使用的字符编码与文件声明一致，输出JSON时也显式指定UTF-8。如果中间经过字符串拼接，注意不要用平台默认编码转换字节。
Q5有没有必要引入第三方库？
如果项目已经使用Jackson或类似库处理JSON，引入其XML模块能减少手写遍历代码；如果只是偶尔转换且结构简单，用JDK自带解析器加少量逻辑也够用。权衡点在于依赖体积与维护成本。