用JAXP的Transformer将Document转byte[]最稳妥：先获取Transformer实例，再用DOMSource封装Document，最后通过ByteArrayOutputStream输出；务必设置transformer.setOutputProperty(OutputKeys.ENCODING, "UTF-8")避免中文乱码。
![xml文件转字节数组 java将document转换为byte[]](https://img.php.cn/upload/article/001/221/864/177164266795737.png)
Document对象怎么转成byte[]？用Transformer最稳
Java里把Document转byte[]，别手写序列化，也别碰DOMImplementationLS这种冷门API——直接走JAXP的Transformer，兼容性好、编码可控、还能处理命名空间和DOCTYPE。
核心就三步：拿到Transformer实例 → 把Document塞进DOMSource → 用ByteArrayOutputStream接输出。中间唯一要盯紧的是编码设置，否则中文变乱码。
-
TransformerFactory.newInstance().newTransformer()就行，不用设OutputKeys.ENCODING——那是输出时用的，不是创建时 - 必须调
transformer.setOutputProperty(OutputKeys.ENCODING, "UTF-8")，否则默认ISO-8859-1，中文全跪 -
DOMSource构造函数只认Node（Document是它的子类），别传Element或NodeList
为什么不用String.getBytes()？字符编码会吃掉你
有人先transform到String再调String.getBytes("UTF-8")，看着省事，实则埋雷：XML声明里的encoding属性（比如<?xml version="1.0" encoding="GBK"?>）和实际字节流编码不一致时，解析器会按声明去读，但你的getBytes()按UTF-8生成，结果就是“明明写了UTF-8却报Invalid byte 1 of 1-byte UTF-8 sequence”。
- XML声明是元信息，不是装饰；
Transformer会把它和实际字节对齐，String中转会切断这个链路 - 如果原始
Document是从GBK文件加载的，但没显式设OutputKeys.ENCODING，Transformer仍按UTF-8输出，此时XML声明却还是GBK——错得更隐蔽 - 真要调试，打印
new String(byteArray, StandardCharsets.UTF_8)看内容，比猜编码靠谱
遇到“Content is not allowed in prolog”错误？多半是BOM或空格
转出来的byte[]喂给InputStream或HTTP body后，下游报Content is not allowed in prolog，八成不是编码问题，而是XML开头多了不可见字符：BOM、UTF-8 BOM（EF BB BF）、或者Transformer前手动拼了换行/空格。
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
立即学习“Java免费学习笔记（深入）”；
-
Transformer默认不加BOM，但如果你用FileOutputStream写文件时用了Writer再转字节，就可能带BOM——这里全程用OutputStream，绕过Writer - 检查
Document本身：用document.getDocumentElement().getFirstChild()看看是不是TEXT_NODE且getNodeValue().trim().isEmpty()，这种空白文本节点会被序列化出来 - 加个过滤：调
transformer.setOutputProperty(OutputKeys.INDENT, "no")，再设OutputKeys.OMIT_XML_DECLARATION, "no"确保声明在最顶行，不被前置空白干扰
大文件或高频转换？注意Transformer不是线程安全的
Transformer实例不能复用在多线程里，官方文档明确写了“not thread-safe”。如果你在Servlet或Spring Bean里单例持有它，高并发下会出诡异的编码错乱或空指针。
- 每次转换都新建
Transformer——开销极小，TransformerFactory才是重的，它可复用 - 如果真卡性能，缓存
TransformerFactory（静态final），但别缓存Transformer - 别为了“省对象”用
ThreadLocal<transformer></transformer>，除非你确定所有调用栈都走同一线程模型；Web容器线程复用会让它失效
真正容易被忽略的是：Document对象本身可能跨线程共享，而Document的Node树不是线程安全的——转之前确认没人在并发修改它。
