Java中如何把DOM对象转为字符串

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

TransformerDocument 转成字符串最可靠

Java 原生不提供 document.toString() 这种直接方式,必须借助 javax.xml.transform 包。核心是用 TransformerDOMSource 转为 StreamResult,再从输出流中读取字符串。

常见错误是漏掉设置输出属性,导致换行丢失或编码错乱;或者用 Node.getTextContent(),那只会返回文本节点拼接结果,完全丢弃标签结构。

  • 务必调用 transformer.setOutputProperty(OutputKeys.OMIT_XML_DECLARATION, "yes"),否则默认会加
  • 编码必须显式设为 "UTF-8",否则中文可能乱码(尤其在 Windows 默认平台编码下)
  • 不要用 ByteAr

    rayOutputStream.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,包括 ElementDocumentFragment 等。但注意:Element 作为根节点序列化时,不会自动补全 声明,这点和 Document 不同。

另外,若该 Element 是从其他文档中 importNode() 过来的,确保已正确设置其 ownerDocument,否则 Transformer 可能抛 NullPointerException

  • 直接传 new DOMSource(element) 即可,无需包装成新 Document
  • 若想保留命名空间前缀(如 ns:tag),需确保源 ElementlookupPrefix() 可访问对应 URI
  • 某些老版本 JDK(如 1.6)的 Transformer 对空命名空间处理不稳定,建议升级到 JDK 8+

别踩 Node.getNodeValue()getTextContent() 的坑

这两个方法根本不是序列化工具:getNodeValue()Element 永远返回 nullgetTextContent() 会递归拼接所有后代文本节点,把 HTML/XML 标签全吃掉,只剩纯文本。

比如有

hello

,调用 div.getTextContent() 得到的是 "hello",而不是带标签的字符串。

  • 仅当明确只需要提取纯文本内容时才用 getTextContent()
  • getNodeValue() 主要用于 TextComment 等节点类型,对 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),而原生方案零依赖
  • 多线程下 JsoupParser 实例是线程安全的,但 Document 不是——别复用解析后的对象
实际中最容易被忽略的是 OutputKeys.INDENTencoding 的组合影响:设了缩进但没设编码,或设了编码但忘了关声明,都会让生成的字符串在下游系统(如 HTTP body、日志入库)里出问题。