spring boot如何处理xml请求 springboot配置xml请求体

星降 2025-11-16 00:00:00 次阅读

Spring Boot需添加jackson-dataformat-xml依赖并配置实体类支持XML映射，通过@RequestBody接收application/xml类型请求，即可实现XML请求处理。

Spring Boot 默认使用 Jackson 作为 JSON 处理引擎，对于 XML 请求的支持需要额外配置。如果你想让 Spring Boot 能接收和处理 XML 格式的请求体（request body），需要完成以下几步：

1. 添加 Jackson XML 依赖

Spring Boot 使用 jackson-dataformat-xml 来支持 XML 序列化和反序列化。在你的 pom.xml 中添加如下依赖：

com.fasterxml.jackson.dataformat
jackson-dataformat-xml

如果你使用 Gradle：

implementation 'com.fasterxml.jackson.dataformat:jackson-dataformat-xml'

2. 确保类有 JAXB 注解或使用 Jackson XML 注解

为了正确解析 XML，你的实体类需要支持 XML 映射。你可以使用 Jackson 的注解，例如：

@Data
@XmlRootElement(name = "user")
public class User {
private String name;
private int age;
}

注意：@XmlRootElement 来自 javax.xml.bind.annotation 包。如果项目是 Java 11+，你可能还需要添加 JAXB 的运行时依赖：

    org.glassfish.jaxb
    jaxb-runtime
    3.0.2

3. 控制器中使用 @RequestBody 接收 XML

在 Controller 方法中，使用 @RequestBody 接收 XML 请求体，并确保请求的 Content-Type 是 application/xml 或 text/xml：

@PostMapping(value = "/user", consumes = "application/xml")
public ResponseEntity createUser(@RequestBody User user) {
    System.out.println("Name: " + user.getName());
    System.out.println("Age: " + user.getAge());
    return ResponseEntity.ok("User created");
}

4. 验证配置是否生效

发送一个 XML 请求测试：

POST /user HTTP/1.1
Content-Type: application/xml

张三
25

如果一切配置正确，Spring Boot 会自动将 XML 反序列化为 User 对象。

5. （可选）全局配置消息转换器

如果你发现 XML 支持未自动注册，可以在配置类中手动添加 Jackson2ObjectMapperBuilder 和 MappingJackson2XmlHttpMessageConverter：

@Configuration
@EnableWebMvc
public class WebConfig {

    @Bean
    public MappingJackson2XmlHttpMessageConverter xmlConverter() {
        Jackson2ObjectMapperBuilder builder = new Jackson2ObjectMapperBuilder()
            .xmlAdapter(JaxbAnnotationModule.class);
        return new MappingJackson2XmlHttpMessageConverter(builder.build());
    }

    @Bean
    public Jaxb2Marshaller jaxb2Marshaller() {
        Jaxb2Marshaller marshaller = new Jaxb2Marshaller();
        marshaller.setPackagesToScan("com.example.demo.entity"); // 替换为你的实体包名
        return marshaller;
    }
}

注意：添加 @EnableWebMvc 会关闭 Spring Boot 的自动配置，除非你有特殊需求，否则不建议使用。