Java添加XML新节点时浏览器报“文档末尾有额外内容”错误

你遇到的这个错误看起来有点迷惑，但其实是两个小细节出了问题，让我一步步给你拆解清楚：

核心问题1：节点添加位置错误 #

你现在的代码把新的<person>节点追加到了第一个已存在的<person>节点内部，而不是作为根节点<persons>的直接子节点。看这段代码：

Element personNode = (Element) root.getElementsByTagName("person").item(0);
// ... 创建newPerson后
personNode.appendChild(newPerson);

这会让你的XML结构变成嵌套的<person>，虽然语法上合法，但肯定不是你想要的效果（你应该是想在<persons>下新增一个同级的person节点）。

核心问题2：未设置正确的响应Content-Type #

你没有告诉浏览器返回的是XML内容，导致Chrome把输出的XML当成HTML来解析——这就会触发“文档末尾有额外内容”的错误，因为HTML的解析规则和XML完全不同，浏览器会把XML标签当成无效的HTML元素，从而报错。

修正后的完整代码 #

InputStream is = sc.getResourceAsStream(_filename);
DocumentBuilderFactory dbFactory = DocumentBuilderFactory.newInstance();
DocumentBuilder db = dbFactory.newDocumentBuilder();
org.w3c.dom.Document document = db.parse(is);
Element root = document.getDocumentElement();

// 创建新的person节点
Element newPerson = document.createElement("person");
Element firstName = document.createElement("fname");
firstName.setTextContent("AppendedNode");
newPerson.appendChild(firstName);

// 关键修改：把新节点加到根节点<persons>下面，和原有person同级
root.appendChild(newPerson);

// 必须设置：告诉浏览器返回的是XML格式
res.setContentType("application/xml");

DOMSource source = new DOMSource(document);
TransformerFactory transformerFactory = TransformerFactory.newInstance();
Transformer transformer = transformerFactory.newTransformer();

// 可选：让输出的XML自动格式化，方便阅读
transformer.setOutputProperty(OutputKeys.INDENT, "yes");
transformer.setOutputProperty("{http://xml.apache.org/xslt}indent-amount", "2");

StreamResult result = new StreamResult(res.getWriter());
transformer.transform(source, result);

额外注意事项 #

• 确保在执行这段代码之前，没有向res.getWriter()写入任何其他内容（比如空格、换行或者HTML片段），否则这些内容会出现在XML文档的开头，破坏XML结构，同样会导致解析错误。
• 如果你的XML需要支持特殊字符，记得补充设置响应的字符编码：res.setCharacterEncoding("UTF-8");。

内容的提问来源于stack exchange，提问作者timdirusso