getAttributeValue 返回 null 的主因是未指定命名空间 URI，而非 XML 或 API 错误；查带命名空间属性必须传入命名空间 URI 和本地名，否则必为 null。
getAttributeValue 返回 null 的常见原因
不是 XML 写错了，也不是 API 用错了，而是 getAttributeValue 默认只查“无命名空间”的属性。如果你的 XML 属性带命名空间（比如 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 下的 xsi:type），不指定命名空间 URI 就一定返回 null。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 确认属性是否在命名空间中：用
getNamespaceCount()和getNamespaceURI(i)检查当前事件是否有声明命名空间 - 查带前缀的属性时，必须传入命名空间 URI + 本地名，例如：
getAttributeValue("http://www.w3.org/2001/XMLSchema-instance", "type") - 如果不确定命名空间，先用
getAttributeCount()遍历所有属性，再用getAttributeNamespace(i)和getAttributeLocalName(i)打印出来看
getAttributeValue(index) 和 getAttributeValue(ns, localName) 的行为差异
两个重载方法底层逻辑不同：按索引查是直接取解析器内部属性表的第 i 项；按命名空间查则会做一次字符串匹配——先比 URI，再比本地名。这意味着后者更安全，但略慢；前者快，但容易因属性顺序变化而错位。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 永远优先用
getAttributeValue(String namespaceURI, String localName)，尤其在属性顺序可能变动（如不同版本 Schema、工具生成 XML）时 -
getAttributeValue(int index)仅适合调试或已知结构绝对稳定的情况，比如解析自己写的固定模板 - 索引从 0 开始，但
getAttributeCount()返回的是当前 startElement 事件中声明的属性总数，别越界
空字符串、缺失属性与 null 的实际含义区别
getAttributeValue 返回 null 只代表“该属性未声明”，不代表值为空。XML 中 <tag attr=""> 和 <tag> 是两回事：前者属性存在且值为空字符串，后者属性根本不存在。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 判断属性是否存在，用
getAttributeValue(...) != null；判断是否为空值，要先非空再.isEmpty() - 不要用
StringUtils.isBlank()一类工具直接判空，它会把null当成空白，掩盖“属性缺失”这个关键语义 - 如果业务上“缺失”和“空字符串”需同等处理，显式写成：
Objects.equals(getAttributeValue(...), "")
StAX 解析器对默认命名空间的特殊处理
XML 声明了 xmlns="http://example.com/ns"，但没给属性加前缀？那这些属性其实属于默认命名空间——但 getAttributeValue 不认这个“默认”，它只认显式绑定的前缀或你手动传入的 URI。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 即使属性没写前缀，只要父元素有
xmlns="..."，它就属于那个命名空间，查的时候必须传对应 URI - 别试图用空字符串
""或null代替命名空间 URI，这在绝大多数 StAX 实现（如 Woodstox、Sun SJSXP）里都查不到 - 一个快速验证法：用
getAttributeNamespace(i)打印每个属性的命名空间，看到非空 URI 就知道该传什么了
getAttributeNamespace(i)，能省掉半天排查时间。 
