如何使用Java Transformer在XML文件中去除空白节点并消除缩进与换行？

本文共计867个文字，预计阅读时间需要4分钟。

由于Transformer默认不压缩格式，会将源XML中的文本节点（包括换行、缩进、空白格）原样保留为：

• 常见错误现象：Node.getNodeType() == Node.TEXT_NODE 却发现内容是 " "，导致遍历时误判子节点数量或内容为空
• 使用场景：生成配置文件、序列化 DTO、对接要求严格 XML 结构的第三方系统（如某些 SOAP 接口）
• 关键点：问题分两层——DOM 构建阶段是否忽略空白、输出阶段是否抑制缩进。只改输出不解决 DOM 内部的冗余 #text 节点

如何在 DOM 解析阶段就丢弃空白文本节点

最彻底的办法是在用 DocumentBuilder 加载 XML 时启用 setIgnoringElementContentWhitespace(true)，但注意它只对 DTD/XSD 声明了元素内容模型（如 element）的文档生效，纯 XML 没声明时无效。

• 更通用的做法：手动遍历并移除空白 #text 节点，例如在解析后调用 removeEmptyTextNodes(document.getDocumentElement())
• removeEmptyTextNodes 函数逻辑很简单：递归检查每个子节点，若类型为 TEXT_NODE 且 getTextContent().trim().isEmpty()，就用 parentNode.removeChild(node)
• 别依赖 normalize()：它只会合并相邻文本节点，不会删除空白节点

Transformer 输出时禁用缩进和换行的正确写法

设置 OutputKeys.INDENT 为 "no" 是基础，但光这样不够——JDK 7+ 的 Transformer 在开启 indent 时会插入换行，关掉后仍可能因原始 DOM 含空白节点而输出多余空格。

• 必须同时设置：transformer.setOutputProperty(OutputKeys.INDENT, "no") 和 transformer.setOutputProperty("{http://xml.apache.org/xslt}indent-amount", "0")
• 如果用了 StreamResult 输出到字符串，确保 StringWriter 没被其他代码意外换行（比如 toString 后手动加 ）
• 验证输出是否干净：用 output.replaceAll("\s+", "") 粗略比对结构，但别用它替代 DOM 清理——这只能掩盖问题

为什么用 DOMSource + StringWriter 容易踩坑

很多人直接把 DOM 丢给 Transformer 输出，却忽略了 DOM 本身是否“干净”。哪怕你设置了 INDENT="no"，只要 DOM 里还卡着 #text 节点，Transformer 就照常输出它们的内容（哪怕只是空格）。

立即学习“Java免费学习笔记（深入）”；

• 典型错误：先用 document.getDocumentElement().getTextContent() 取值，结果拿到一堆换行和缩进——这不是 Transformer 的错，是 DOM 里文本节点没清理
• 调试建议：输出前用 XMLUtil.printNode(document)（自定义函数）逐层打印节点类型和内容，快速定位哪一层混入了空白 #text
• 兼容性提醒：不同 JDK 版本对 INDENT 的处理略有差异，OpenJDK 11+ 更严格，Oracle JDK 8 有时会“假装忽略”空白节点

DOM 里的空白节点不像字符串空格那么好 trim，得一层层亲手删；而 Transformer 只负责忠实翻译 DOM 树，它不管这棵树干不干净。