StaxEventItemReader 可流式读取大型 XML 文件，避免内存溢出，适用于结构扁平、重复标签（如 order）的场景；需配置 resource、fragmentRootElementName、unmarshaller 等，并确保 Java Bean 含正确 JAXB 注解。
Spring Batch 使用 StaxEventItemReader 可以高效、流式地读取大型 XML 文件，避免将整个文档加载到内存，适合处理结构清晰、重复标签的 XML 数据（如订单列表、用户清单等）。它基于 StAX（Streaming API for XML），底层使用 Woodstox 或 JDK 自带的 StAX 实现。
XML 结构需满足可映射前提
StaxEventItemReader 不解析任意嵌套 XML，它依赖“扁平化”的重复元素作为业务对象单位。例如：
<?xml version="1.0" encoding="UTF-8"?>
<orders>
<order id="1001">
<customerName>Alice</customerName>
<amount>299.99</amount>
</order>
<order id="1002">
<customerName>Bob</customerName>
<amount>149.50</amount>
</order>
</orders>
其中每个 <order> 是一个独立 item，StaxEventItemReader 会逐个提取并映射为 Java 对象。
配置 StaxEventItemReader 的关键项
需指定资源路径、根标签名、映射处理器（Unmarshaller）及命名空间（如有）：
-
resource：XML 文件路径，支持
FileSystemResource、ClassPathResource等 -
fragmentRootElementName：每个 item 对应的 XML 元素名（如
"order"） -
unmarshaller：用
Jaxb2Marshaller将 XML 片段反序列化为 Java Bean（Bean 需加@XmlRootElement和字段级@XmlElement） -
namespaceAware：设为
true若 XML 含命名空间（如xmlns="http://example.com/ns"），此时需在unmarshaller中注册 namespace handler 或使用@XmlSchema
写入 XML：用 StaxEventItemWriter
对应读取，StaxEventItemWriter 支持流式写入。需配置：
-
resource：输出文件路径（如
FileSystemResource("output/orders.xml")） -
rootTagName：外层容器标签名（如
"orders"） -
marshaller：同样用
Jaxb2Marshaller，确保目标类有正确 JAXB 注解 -
overwriteOutput：设为
true允许覆盖已有文件（默认 false，写入失败）
注意：它不会自动添加 XML 声明（<?xml version="1.0"?>），如需，可在 StaxEventItemWriter 初始化后调用 setXmlDeclaration(true)（Spring Batch 5+ 支持）。
常见问题与建议
避免运行时异常的关键细节：
- 确保 XML 中每个 fragment 元素是合法、闭合的；含非法字符或未闭合标签会导致
XMLStreamException - Java Bean 字段名与 XML 标签名不一致时，用
@XmlElement(name = "customerName")显式指定 - 属性值（如
id="1001"）需用@XmlAttribute注解，不能用@XmlElement - 若 XML 含 CDATA 或特殊编码，确认
InputStream指定正确 charset（如 UTF-8），并在Resource构造时传入
不复杂但容易忽略。
