如何通过Java读取XML文件并获取根节点的元素名称？

本文共计808个文字，预计阅读时间需要4分钟。

直接调用 `Document.getDocumentElement()` 方法可以获取文档的根元素，这是最常用也是最稳定的做法。这种方法不依赖于XML是否有声明、注释或空白文本节点，可以准确地返回实际的根元素。

• 必须先用 DocumentBuilder.parse() 解析输入源（File、InputStream 或 String），不能跳过解析步骤
• 如果XML开头有BOM（如UTF-8带BOM），可能导致解析失败，报错 org.xml.sax.SAXParseException: Content is not allowed in prolog，需提前过滤BOM字节
• getDocumentElement() 返回 null 仅说明文档为空或解析失败，不是“没找到根节点”，要检查异常和输入流是否已耗尽

DOM解析时忽略空白文本节点的影响

XML中换行缩进产生的空白文本节点，在DOM树里是真实存在的 Text 节点。但 getDocumentElement() 本身不受其干扰——它只返回第一个 Element 类型子节点，跳过所有非Element节点。

• 不必手动遍历 childNodes 过滤 Node.TEXT_NODE 来找根，那是SAX或低层DOM操作才需要的逻辑
• 若误用 document.getFirstChild().getNodeName()，可能拿到 #text 或 #comment，导致空指针或名称错误
• 验证方式很简单：打印 document.getDocumentElement().getNodeName()，结果应为预期的根标签名，如 "config" 或 "root"

用XPath快速提取根元素名（适合已有Document对象）

当已经拿到 Document 对象，又不想调用方法链时，XPath是更声明式的替代方案，但要注意初始化开销和线程安全。

• 表达式写成 "/*[1]" 或简写为 "/" 都可以匹配根元素；用 "name(/*)" 可直接返回字符串名，避免后续调用 getNodeName()
• 必须显式设置 XPathFactory.newInstance().newXPath()，JDK自带实现默认线程不安全，多线程复用同一 XPath 实例会出问题
• 性能上比 getDocumentElement() 略低，因为涉及表达式编译和执行，纯取根名没必要舍近求远

常见错误：SAXParser误当DOM用

有人看到“SAX”就以为能快速读根名，试图在 startElement() 回调里判断是否为第一个元素。这不可靠——SAX不保证回调顺序绝对严格（尤其含外部DTD时），且无法回溯。

立即学习“Java免费学习笔记（深入）”；

• 错误现象：XML开头有 <?xml version="1.0"?> 和注释时，startElement() 第一次触发的确实是根，但一旦加了 <!DOCTYPE ...> 或实体引用，行为可能变化
• 根本原因：SAX是事件驱动流式解析，没有“文档结构视图”，不存在 getRootElement() 这种API
• 正确做法：要根名就用DOM；真要流式处理且只关心根，可在首次 startElement() 时记录并跳出，但必须配合 setFeature("http://apache.org/xml/features/disallow-doctype-decl", true) 防止DTD干扰

根元素名称看似简单，但混用解析模型、忽略BOM、误信SAX回调序号，这三个点最容易在上线后突然暴露。别图省事绕开 DocumentBuilder 的标准路径。