Java 17+ 的 record 与 JAXB 根本不兼容，因 record 无无参构造器、不可变、无 setter，且 JAXB RI 自 Java 14+ 明确拒绝 record 类型；推荐采用双层建模（JAXB class + record 转换）或改用 Jackson XML（2.12+ 支持 record）。
Java 17+ 的 record 无法直接被 JAXB（javax.xml.bind）处理，因为 JAXB 要求类具备无参构造器、可变字段、getter/setter 方法，而 record 天然不可变、无无参构造器、字段私有且无 setter —— 这不是配置问题，是根本性不兼容。
为什么 JAXB 会抛 IllegalArgumentException: Class is an interface or a record
JAXB RI（如 Metro）在 Java 14+ 明确拒绝处理 record 类型，底层反射检查到 Class.isRecord() 返回 true 就直接失败。即使你用 @XmlRootElement 或 @XmlAccessorType(XmlAccessType.FIELD) 修饰，也绕不过这个校验。
- JAXB 实现（如
com.sun.xml.bind.v2.runtime.JAXBContextImpl）在构建元模型时强制排除record - Java 17 移除了
java.xml.bind模块，JAXB 已是第三方库，其最新维护版本（2.3.9+）仍未支持record - 哪怕降级到 Java 11 + JAXB 2.3.3，
record仍因缺少无参构造器导致UnmarshalException
替代方案：用普通 class + record 双层建模
保持 API 层用 record 提供不可变语义，XML 解析层用传统 class 承接 JAXB，再手动或通过工具转换。这是目前最稳定、零运行时风险的做法。
- 定义一个与
record字段完全一致的XmlUploadRequest类，含无参构造器、public 字段（或 private + getter/setter），并添加 JAXB 注解 - 接收 XML 时用
JAXBContext.newInstance(XmlUploadRequest.class).createUnmarshaller().unmarshal()解析 - 解析后调用静态工厂方法转为业务
record：public static UploadRequest fromXml(XmlUploadRequest xml) { return new UploadRequest(xml.getId(), xml.getName(), xml.getPayload()); } - 避免在
record上加 JAXB 注解（无效），也不要用@XmlType(propOrder = {...})去“骗过”解析器
如果坚持单类型：放弃 JAXB，改用 Jackson XML
com.fasterxml.jackson.dataformat:jackson-dataformat-xml 支持 Java 14+ record（需 Jackson 2.12+），且无需无参构造器，靠 `ParameterNamesModule` 和 `@JsonCreator` 即可工作。
立即学习“Java免费学习笔记（深入）”；
- 启用
ParameterNamesModule并注册到XmlMapper：XmlMapper xmlMapper = new XmlMapper(); xmlMapper.registerModule(new ParameterNamesModule());
-
record必须用@JsonCreator显式标注构造器（否则 Jackson 无法识别参数名）：public record UploadRequest(@JacksonXmlProperty String id, @JacksonXmlProperty String name) {} - 注意：默认字段名映射为 XML 元素名（非属性），如需属性需加
@JacksonXmlProperty(isAttribute = true) - 不支持
@XmlJavaTypeAdapter等 JAXB 特有机制，自定义序列化需实现JsonSerializer/JsonDeserializer
真正麻烦的不是怎么写代码，而是团队是否接受「XML 解析层和领域模型分离」这个事实——JAXB 和 record 的哲学冲突无法靠注解弥合，硬凑只会让错误延迟到运行时才暴露。
