getLocalName返回空或null的主因是XMLInputFactory未启用命名空间感知，必须显式设置IS_NAMESPACE_AWARE为true；否则在含前缀标签（如<ns:user>）时失效，而无前缀标签（如<user>）则正常。
getLocalName 返回空字符串或 null 的常见原因
不是你的 XML 写错了，也不是 API 坏了，而是 XMLStreamReader 默认不解析命名空间时，getLocalName() 就会失效。它只在启用了命名空间感知（namespace-aware）的解析器下才可靠返回不带前缀的本地名。
- 默认构造的
XMLInputFactory实例通常关闭命名空间支持，必须显式开启：factory.setProperty(XMLInputFactory.IS_NAMESPACE_AWARE, true) - 如果 XML 中标签没声明命名空间（比如
<user>），getLocalName()正常；但一旦有前缀（如<ns:user>）且工厂没设 namespace-aware，它可能返回null或空串 - 某些 JDK 版本（如早期 OpenJDK 8u）在禁用命名空间时对
getLocalName()行为不一致，别依赖“看起来能跑”
如何安全获取不带前缀的标签名（兼容无/有命名空间场景）
别只靠 getLocalName()，它在命名空间关闭时不可靠；也别用 getQName().getLocalPart() —— 这个方法在部分 StAX 实现里抛 UnsupportedOperationException。
- 优先用
getLocalName()，但前提是确认工厂已设IS_NAMESPACE_AWARE = true - 兜底方案：当
getLocalName()为空时，用getQualifiedName()切分，例如qname.substring(qname.indexOf(':') + 1)，但要注意没有冒号的情况 - 更稳的做法是直接用
getLocalName().isEmpty() ? getQualifiedName() : getLocalName()，再加一层空判断
getLocalName 和 getQualifiedName 的行为差异
这两个方法根本不是互为备份的关系，它们反映的是不同解析模式下的产物：
-
getLocalName()：仅在 namespace-aware 模式下有意义，返回去掉前缀后的本地名（如<ns:user>→"user"）；否则返回空或null -
getQualifiedName()：始终返回完整限定名（如"ns:user"或"user"），不依赖命名空间开关，但需自己拆解 - 注意：
getPrefix()在 namespace-aware 关闭时也可能返回空，不能用来推断前缀是否存在
一个最小可验证的初始化写法（避免踩坑）
很多问题其实出在工厂配置那一步，不是读取逻辑本身。下面这段才是生产环境该写的初始化代码：
立即学习“Java免费学习笔记（深入）”；
XMLInputFactory factory = XMLInputFactory.newInstance(); factory.setProperty(XMLInputFactory.IS_NAMESPACE_AWARE, true); // 必须加这一行，否则 getLocalName 不保证可用 factory.setProperty(XMLInputFactory.SUPPORT_DTD, false); // 可选，防 XXE XMLStreamReader reader = factory.createXMLStreamReader(inputStream);
漏掉第一行 IS_NAMESPACE_AWARE 设置，后面所有基于 getLocalName() 的分支逻辑都可能在某次部署后突然失效——尤其是当上游 XML 开始加命名空间时。
命名空间不是“用不用”的问题，是“解析器知不知道它存在”的问题。一旦 XML 出现前缀，而你的解析器没被告知要关心命名空间，它就只会把 ns:user 当成一个整体字符串，getLocalName() 自然没东西可报。
