在Java 17及以上版本中，Record已经成为建模不可变数据的首选方式，但JAXB作为老牌XML绑定框架，其反序列化机制至今仍默认要求目标类具备无参构造器以及可写的字段或属性。很多开发者在把Record类型直接交给JAXBContext时会遇到异常，根本原因并非Record本身有缺陷，而是JAXB的实例化策略与Record的设计理念相冲突。要解决这个问题，需要引入一个适配层来桥接两者。

Record与JAXB的冲突根源

Record没有无参构造器，所有字段都是final，JAXB的默认反序列化流程是：调用无参构造器创建实例，然后通过setter或反射直接写入字段值。Record字段无法被反射修改（虽然可以使用Unsafe，但JAXB不这样做），因此会抛出异常。即使在Record上标注@XmlRootElement，也不会改变JAXB的实例化策略。

下面定义一个简单的Record：

public record UserRecord(String name, int age) {}

如果直接尝试解组：

JAXBContext context = JAXBContext.newInstance(UserRecord.class);
Unmarshaller unmarshaller = context.createUnmarshaller();
UserRecord user = (UserRecord) unmarshaller.unmarshal(new File("user.xml"));

运行时会看到类似于class UserRecord does not have a no-arg default constructor的异常。这是因为JAXB无法创建Record实例。要解决这个问题，最干净的做法是使用XmlAdapter，让一个普通的JavaBean承担XML绑定职责，再由适配器完成Bean到Record的转换。

使用XmlAdapter实现Record与JAXB互转

XmlAdapter是JAXB提供的一个抽象类，带有两个泛型参数：ValueType和BoundType。其中ValueType是JAXB可以直接处理的类型，BoundType是实际想要使用的类型。适配器需要实现marshal和unmarshal方法。

假设XML结构如下：

<user>
    <name>张三</name>
    <age>30</age>
</user>

对应的Record定义为：

public record UserRecord(String name, int age) {}

我们需要一个可变的JavaBean来匹配XML：

public class UserDto {
    private String name;
    private int age;
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
    public int getAge() { return age; }
    public void setAge(int age) { this.age = age; }
}

然后定义适配器：

import jakarta.xml.bind.annotation.adapters.XmlAdapter;
public class UserAdapter extends XmlAdapter<UserDto, UserRecord> {
    @Override
    public UserRecord unmarshal(UserDto dto) throws Exception {
        return new UserRecord(dto.getName(), dto.getAge());
    }
    @Override
    public UserDto marshal(UserRecord record) throws Exception {
        UserDto dto = new UserDto();
        dto.setName(record.name());
        dto.setAge(record.age());
        return dto;
    }
}

在Record上通过@XmlJavaTypeAdapter注解指定适配器：

import jakarta.xml.bind.annotation.adapters.XmlJavaTypeAdapter;
@XmlJavaTypeAdapter(UserAdapter.class)
public record UserRecord(String name, int age) {}

这样JAXB在创建上下文时就会识别适配器。需要注意的是，@XmlJavaTypeAdapter既可以放在类级别，也可以放在字段或包级别。放在Record类级别最直接。如果Record用于多个场景，也可以注册全局适配器。为了减少每个Record都写一个适配器的重复劳动，可以利用泛型与反射封装一个通用的适配器基类，但实现复杂度较高，需要处理字段映射和类型转换，简单场景下手写适配器反而更清晰。

在Spring Boot中处理XML上传并解析为Record

在实际项目中，XML上传通常通过HTTP multipart请求接收。Spring Boot中可以使用MultipartFile获取文件，然后交给JAXB解析。首先要确保引入Jakarta XML Binding依赖：

<dependency>
    <groupId>jakarta.xml.bind</groupId>
    <artifactId>jakarta.xml.bind-api</artifactId>
    <version>4.0.2</version>
</dependency>
<dependency>
    <groupId>org.glassfish.jaxb</groupId>
    <artifactId>jaxb-runtime</artifactId>
    <version>4.0.5</version>
</dependency>

控制器接收文件并解析：

import org.springframework.web.bind.annotation.*;
import org.springframework.web.multipart.MultipartFile;
import jakarta.xml.bind.*;
import java.io.InputStream;
@RestController
@RequestMapping("/api/xml")
public class XmlUploadController {
    @PostMapping("/user")
    public UserRecord uploadUser(@RequestParam("file") MultipartFile file) throws Exception {
        JAXBContext context = JAXBContext.newInstance(UserRecord.class);
        Unmarshaller unmarshaller = context.createUnmarshaller();
        try (InputStream is = file.getInputStream()) {
            return (UserRecord) unmarshaller.unmarshal(is);
        }
    }
}

这里直接使用了带有@XmlJavaTypeAdapter的UserRecord作为JAXBContext的入口类，适配器会自动将UserDto转换为UserRecord。注意JAXBContext的创建有一定的开销，如果性能敏感，可以考虑缓存为单例。

安全方面，解析XML时必须防范XXE攻击。JAXB默认可能允许外部实体，需要显式关闭：

import javax.xml.XMLConstants;
import javax.xml.stream.XMLInputFactory;
import javax.xml.stream.XMLStreamReader;
XMLInputFactory xif = XMLInputFactory.newFactory();
xif.setProperty(XMLConstants.ACCESS_EXTERNAL_DTD, "");
xif.setProperty(XMLConstants.ACCESS_EXTERNAL_SCHEMA, "");
xif.setProperty(XMLInputFactory.SUPPORT_DTD, false);
XMLStreamReader xsr = xif.createXMLStreamReader(is);
Object obj = unmarshaller.unmarshal(xsr);

此段代码展示了更安全的解组方式。同时建议设置Unmarshaller的Schema校验，以及限制文件大小来防止内存耗尽。

替代方案与注意事项

虽然XmlAdapter是目前让Record与JAXB协同工作的标准途径，但也要看到它的局限：每个Record都需要一个对应的Bean和适配器，代码量增加明显。如果项目里XML结构很多，可以考虑使用Jackson XML（jackson-dataformat-xml），它对Record的支持更现代化，可以直接通过Jackson注解绑定。不过Jackson XML的底层使用的是Woodstox，与JAXB生态的注解不兼容，迁移时需要权衡。

另一个思路是放弃直接绑定，定义独立的DTO层，解析完成后再手动映射到Record。这种方式代码更直白，但会丢失声明式映射的简洁性。使用适配器其实就是在DTO和Record之间架桥，本质上没有区别。

还有一点需要注意：JAXB版本。Java 17移除了Java EE模块，必须显式引入Jakarta版本的JAXB。如果混用了javax.xml.bind旧包，会出现ClassNotFoundException。所有import都要使用jakarta.xml.bind开头。