@xmlelement 生成子节点，@xmlattribute 生成属性；前者用于嵌套结构，后者适用于轻量、不可变的元数据如主键、状态码等，且仅支持简单类型。
@XmlElement 和 @XmlAttribute 的根本区别在哪？
区别不在“写法”，而在 XML 结构语义：@XmlElement 生成子节点（嵌套结构），@XmlAttribute 生成属性（同一层级的 key=”value”）。这是设计阶段就要决定的——不是“哪个更方便”，而是“XML Schema 要求它是什么”。
什么时候必须用 @XmlAttribute？
适合标示轻量、不可变、用于标识或控制的元数据，比如业务主键、状态码、版本号、是否启用等。这类字段通常：
- 类型是简单类型（
String、int、Boolean、enum），不能是自定义对象（如Address） - 值较短，不带格式、不支持换行或 CDATA
- 在 XML 中常与
@XmlElement混用，构成“属性 + 内容”的标准模式，例如：<order orderId="ORD-2026-001" status="shipped"> <description>笔记本电脑套装</description> <items>...</items> </order>
为什么加了 @XmlAttribute 却没出现在 XML 里？
常见原因有三个，按发生频率排序：
- 字段为
NULL或空字符串，且没设defaultValue→ JAXB 默认跳过该属性（不会输出status=""） - 类没加
@XmlRootElement，或没配@XmlAccessorType(XmlAccessType.FIELD)→ 字段级注解被忽略（JAXB 默认只处理 getter 方法） - 字段类型是复杂对象（比如
private Address address;）→ 运行时报IllegalArgumentException: class Address is not known to this context
@XmlElement 的 name 和 @XmlAttribute 的 name 参数一样吗？
行为一致，但作用域不同：
-
@XmlElement(name = "full_name")→ 输出为<full_name>张三</full_name> -
@XmlAttribute(name = "id")→ 输出为<person id="123"></person> - 两者都支持
required = true，但效果不同：@XmlAttribute(required=true)反序列化时若缺失会抛UnmarshalException；@XmlElement(required=true)缺失则直接失败，不进对象
真正容易被忽略的是：如果字段名本身含下划线或大小写混合（如 orderStatus），不显式写 name，JAXB 默认按驼峰转连字符规则生成（order-status），而这不是所有 XML Schema 都接受的。