最可靠方式是用javax.xml.transform.Transformer将DOMSource转为StreamResult,再通过ByteArrayOutputStream.toString("UTF-8")获取字符串;务必设置OMIT_XML_DECLARATION="yes"和显式UTF-8编码,禁用getTextContent()等非序列化方法。

用 Transformer 将 Document 转成字符串最可靠
Java 原生不提供 document.toString() 这种直接方式,必须借助 javax.xml.transform 包。核心是用 Transformer 把 DOMSource 转为 StreamResult,再从输出流中读取字符串。
常见错误是漏掉设置输出属性,导致换行丢失或编码错乱;或者用 Node.getTextContent(),那只会返回文本节点拼接结果,完全丢弃标签结构。
- 务必调用
transformer.setOutputProperty(OutputKeys.OMIT_XML_DECLARATION, "yes"),否则默认会加 - 编码必须显式设为
"UTF-8",否则中文可能乱码(尤其在 Windows 默认平台编码下) - 不要用
ByteArrayOutputStream.toString(),它依赖平台默认编码;应调用baos.toString("UTF-8")
Document doc = ...; // 已构建好的 DOM Document
TransformerFactory factory = TransformerFactory.newInstance();
Transformer transformer = factory.newTransformer();
transformer.setOutputProperty(OutputKeys.OMIT_XML_DECLARATION, "yes");
transformer.setOutputProperty(OutputKeys.INDENT, "no"); // 如需缩进,设为 "yes" 并加 setOutputProperty("{http://xml.apache.org/xslt}indent-amount", "2")
try (StringWriter writer = new StringWriter();
ByteArrayOutputStream baos = new ByteArrayOutputStream()) {
StreamResult result = new StreamResult(baos);
transformer.transform(new DOMSource(doc), result);
String xmlStr = baos.toString("UTF-8");
System.out.println(xmlStr);
}
如果只要序列化某个 Element 而非整个 Document
DOMSource 构造器支持传入任意 Node,包括 Element、DocumentFragment 等。但注意:Element 作为根节点序列化时,不会自动补全 声明,这点和 Document 不同。
另外,若该 Element 是从其他文档中 importNode() 过来的,确保已正确设置其 ownerDocument,否则 Transformer 可能抛 NullPointerException。
立即学习“Java免费学习笔记(深入)”;
- 直接传
new DOMSource(element)即可,无需包装成新Document - 若想保留命名空间前缀(如
ns:tag),需确保源Element的lookupPrefix()可访问对应 URI - 某些老版本 JDK(如 1.6)的
Transformer对空命名空间处理不稳定,建议升级到 JDK 8+
别踩 Node.getNodeValue() 和 getTextContent() 的坑
这两个方法根本不是序列化工具:getNodeValue() 对 Element 永远返回 null;getTextContent() 会递归拼接所有后代文本节点,把 HTML/XML 标签全吃掉,只剩纯文本。
比如有 hello,调用 div.getTextContent() 得到的是 "hello",而不是带标签的字符串。
- 仅当明确只需要提取纯文本内容时才用
getTextContent() -
getNodeValue()主要用于Text、Comment等节点类型,对Element无意义 - 试图用
element.getAttribute("outerHTML")会报错——DOM Level 3 里根本没有这个属性
第三方库(如 Jsoup)适合快速原型,但注意场景限制
如果项目已引入 jsoup,可以用 Jsoup.parse(...).html() 或 element.outerHtml() 快速获得字符串。但它本质是 HTML 解析器,对 XML 兼容性差:不校验命名空间、会自动修正非法标签、忽略 DOCTYPE 声明等。
所以只推荐用于 HTML 片段生成或测试环境;生产环境处理严格 XML(如 SOAP、配置文件)仍应坚持原生 Transformer 方案。
-
Jsoup.parse(xmlString, "", Parser.xmlParser()).outerHtml()可勉强支持简单 XML,但无法处理 CDATA、处理指令(PI)、注释位置等细节 - 依赖额外 JAR(约 300KB),而原生方案零依赖
- 多线程下
Jsoup的Parser实例是线程安全的,但Document不是——别复用解析后的对象
OutputKeys.INDENT 和 encoding 的组合影响:设了缩进但没设编码,或设了编码但忘了关声明,都会让生成的字符串在下游系统(如 HTTP body、日志入库)里出问题。










