最可靠方式是用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")，否则默认会加<?xml version="1.0" encoding="UTF-8"?> - 编码必须显式设为
"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 作为根节点序列化时，不会自动补全 <?xml ...?> 声明，这点和 Document 不同。
另外，若该 Element 是从其他文档中 importNode() 过来的，确保已正确设置其 ownerDocument，否则 Transformer 可能抛 NullPointerException。
立即学习“Java免费学习笔记（深入）”；
诊断并恢复通过 SSH 隧道连接的 OpenClaw 节点。用于解决配对必需错误、隧道冲突、远程端点错误以及 SSH 目标配置错误等问题。
- 直接传
new DOMSource(element)即可，无需包装成新Document - 若想保留命名空间前缀（如
ns:tag），需确保源Element的lookupPrefix()可访问对应 URI - 某些老版本 JDK（如 1.6）的
Transformer对空命名空间处理不稳定，建议升级到 JDK 8+
别踩 Node.getNodeValue() 和 getTextContent() 的坑
这两个方法根本不是序列化工具：getNodeValue() 对 Element 永远返回 null；getTextContent() 会递归拼接所有后代文本节点，把 HTML/XML 标签全吃掉，只剩纯文本。
比如有 <div><p>hello</p></div>，调用 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、日志入库）里出问题。 
