writeendelement() 不写闭合标签是因为它只匹配最近未配对的 writestartelement()，若无对应开始标签则抛异常；必须确保每个 writeendelement() 前有且仅有一个对应层级的 writestartelement()，并注意命名空间声明和空元素区别。
writeEndElement() 不写闭合标签？检查是否漏调了 writeStartElement()
StAX 的 XMLStreamWriter 是状态驱动的，writeEndElement() 本身不“凭空”写结束标签，它只匹配最近一次未配对的 writeStartElement()。如果之前没调过 writeStartElement()，或者调了但被异常中断、提前 return，调 writeEndElement() 就会抛 XMLStreamException，提示“no open start element”之类。
常见错误现象：writeEndElement() 没生效、XML 输出缺失闭合标签、或直接报错中断。
- 确认每个
writeEndElement()前都有且仅有一个对应层级的writeStartElement() - 避免在 try-catch 中吞掉异常后继续调用
writeEndElement()—— 状态已乱，再调必错 - 嵌套较深时，建议用栈记录元素名（如
Deque<string></string>），出作用域时 pop 并校验，比靠人脑追踪更可靠
writeEndElement() 和 writeEmptyElement() 的行为区别
writeEmptyElement("tag") 直接输出 <tag></tag>，不进入“打开状态”，后续不能对它调 writeEndElement()；而 writeStartElement("tag") + writeEndElement() 生成的是 <tag></tag>（或缩写形式，取决于实现和配置）。
使用场景：生成自闭合标签（如 <img src="x" alt="Java XMLStreamWriter writeEndElement StAX写入结束标签" >）必须用 writeEmptyElement() 或 writeStartElement() + writeAttribute() + writeEndElement() 组合，不能指望 writeEndElement() “自动转成自闭合”。
立即学习“Java免费学习笔记（深入）”；
-
writeEmptyElement("br")→<br> -
writeStartElement("br"); writeEndElement()→<br>（除非底层实现启用了空元素优化，但不可依赖） - 想控制是否缩写，得看具体
XMLOutputFactory实现（如 Woodstox 支持OUTPUT_INDENTATION，但不控制空元素形态）
writeEndElement() 在命名空间上下文中的坑
当用 writeStartElement(String namespaceURI, String localName) 开启带命名空间的元素时，writeEndElement() 会自动写出带前缀的结束标签（如 <tag></tag>），但前提是命名空间前缀已在作用域内声明过 —— 通常是通过 writeNamespace() 或 writeDefaultNamespace() 显式绑定的。
常见错误现象：结束标签没带前缀（如 <tag></tag>），导致 XML 无效或解析失败。
- 不要只在
writeStartElement()里传 namespaceURI，就以为前缀自动存在 —— 必须提前调writeNamespace("ns", "http://example.com") - 如果元素属于默认命名空间，用
writeDefaultNamespace("http://example.com")，否则writeEndElement()可能生成无前缀且无默认声明的结束标签 - Woodstox 等实现会在 close 时尝试补默认声明，但标准 StAX 不保证，别依赖
性能与流式写入的隐含约束
writeEndElement() 本身开销极小，但它的正确性高度依赖调用顺序和流状态。一旦顺序错、嵌套断、命名空间漏，整个流可能卡死、抛异常，或输出非法 XML —— 这类问题在线上环境往往表现为下游系统解析失败，排查成本远高于写代码成本。
最容易被忽略的是：StAX 写入器不缓存整棵树，也不做语法校验，它只忠实地按你调用的顺序输出字符。所以逻辑分支多、异常路径杂的场景，要格外小心 writeEndElement() 的配对。
- 避免在 if/else 分支中只有一边调
writeStartElement()却两边都调writeEndElement() - 资源关闭前务必确保所有
writeStartElement()都被writeEndElement()匹配，否则close()可能抛异常或截断输出 - 单元测试里用
XMLInputFactory回读生成结果，比肉眼检查更早暴露配对问题
