JAXB默认不为集合字段生成wrapper元素，必须显式使用@XmlElementWrapper注解；若缺失或配置错误，会导致空集合、字段忽略或序列化异常。
@XmlElementWrapper 和 @XmlElement 一起用时，JAXB 默认会把集合字段序列化成带包装元素的 XML 结构；但若只加 @XmlElement、漏掉 @XmlElementWrapper，或顺序/类型不匹配，就会出现空集合、字段被忽略、甚至 NullPointerException 或 MarshalException。
为什么集合字段不生成 wrapper 元素？
默认情况下，JAXB 对 List 字段只生成多个同名子元素，不会自动加外层包装。必须显式用 @XmlElementWrapper 声明包装标签名，否则 XML 中看不到类似 <items> 这样的容器。
-
@XmlElementWrapper必须标注在集合字段（或 getter）上，不能只标@XmlElement - 若字段是
private List<String> names;，@XmlElementWrapper(name = "nameList")控制外层标签，@XmlElement(name = "name")控制每个条目标签 - 两者 name 值互不影响，但命名冲突会导致 XML 结构混乱（比如都叫
item）
反序列化时 list 为空或报 UnmarshalException？
常见原因是 XML 结构与注解不一致：比如 Java 类期望 <orders><order>...</order></orders>，但实际 XML 是 <order>...</order><order>...</order>（无 wrapper），此时 JAXB 无法自动绑定到带 @XmlElementWrapper 的字段，list 保持 null 或空。
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
- 检查 XML 实际结构是否含 wrapper 元素；若不含，去掉
@XmlElementWrapper，只留@XmlElement - 若 XML 可能两种格式共存（有/无 wrapper），JAXB 本身不支持弹性解析，需改用
@XmlAnyElement+ 手动解析，或换 Jackson +@JacksonXmlElementWrapper -
@XmlElementWrapper(required = false)不影响反序列化逻辑，仅用于 XSD 生成，对运行时无作用
嵌套集合或泛型类型写错导致 marshal 失败
JAXB 对泛型擦除敏感。如果集合字段声明为 List 但没配 @XmlElement 的 type 或 namespace，且元素类型不是 public 简单类型（如自定义类），marshal 可能抛 IllegalArgumentException: class XXX nor any of its super class is known to this context。
立即学习“Java免费学习笔记（深入）”；
- 确保集合元素类型类上有
@XmlRootElement，或在JAXBContext.newInstance(...)中显式传入该类型 - 若用
@XmlElement(type = MyItem.class)，type 必须是实际运行时能实例化的类，不能是接口或抽象类（除非配了@XmlJavaTypeAdapter） -
@XmlElementWrapper不能标注在数组字段上（如MyItem[] items），JAXB 会忽略它；必须用List或其它Collection子类型
public class Order {
@XmlElementWrapper(name = "items")
@XmlElement(name = "item", type = Item.class)
private List<Item> itemList;
// getter/setter...
}
@XmlRootElement
public class Item {
@XmlElement
private String name;
}
最容易被忽略的是：JAXB 要求集合字段的 getter/setter 必须存在且可访问（哪怕只是 public void setItemList(List<Item> list) {}），否则运行时可能静默跳过该字段 —— 尤其在 Lombok 项目中，记得加 @Getter @Setter 或手动补全。
