Spring Boot RestController如何在XML反序列化时遵循JAXB注解？

AI 小北

2026-5-20

问题场景与示例代码

先把你提到的最小化示例代码整理出来，方便理解问题：

build.gradle

plugins {
    id 'org.springframework.boot' version '2.7.5'
    id 'io.spring.dependency-management' version '1.0.15.RELEASE'
    id 'java'
}

group = 'com.example'
version = '0.0.1-SNAPSHOT'
sourceCompatibility = '11'

repositories {
    mavenCentral()
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
    implementation 'com.fasterxml.jackson.dataformat:jackson-dataformat-xml'
    testImplementation 'org.springframework.boot:spring-boot-starter-test'
    testImplementation 'io.rest-assured:rest-assured'
}

tasks.named('test') {
    useJUnitPlatform()
}

主类

package com.example.xmlvalidation;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class XmlValidationApplication {
    public static void main(String[] args) {
        SpringApplication.run(XmlValidationApplication.class, args);
    }
}

RestController端点

package com.example.xmlvalidation;

import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class UserController {

    @PostMapping(value = "/users", consumes = "application/xml", produces = "application/xml")
    public ResponseEntity<UserResponse> createUser(@RequestBody UserRequest request) {
        UserResponse response = new UserResponse();
        response.setId(1L);
        response.setName(request.getName());
        return ResponseEntity.ok(response);
    }
}

请求模型（带JAXB注解）

package com.example.xmlvalidation;

import javax.xml.bind.annotation.XmlElement;
import javax.xml.bind.annotation.XmlRootElement;

@XmlRootElement(name = "user")
public class UserRequest {

    private String name;

    @XmlElement(required = true)
    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }
}

响应模型

package com.example.xmlvalidation;

import javax.xml.bind.annotation.XmlElement;
import javax.xml.bind.annotation.XmlRootElement;

@XmlRootElement(name = "userResponse")
public class UserResponse {

    private Long id;
    private String name;

    @XmlElement
    public Long getId() {
        return id;
    }

    public void setId(Long id) {
        this.id = id;
    }

    @XmlElement
    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }
}

测试类

package com.example.xmlvalidation;

import io.restassured.RestAssured;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.boot.test.web.server.LocalServerPort;

import static io.restassured.RestAssured.given;
import static org.hamcrest.Matchers.equalTo;

@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
class UserControllerTest {

    @LocalServerPort
    private int port;

    @BeforeEach
    void setUp() {
        RestAssured.baseURI = "http://localhost:" + port;
    }

    @Test
    void shouldAcceptValidRequest() {
        String xml = "<user><name>John Doe</name></user>";

        given()
                .contentType("application/xml")
                .body(xml)
                .when()
                .post("/users")
                .then()
                .statusCode(200)
                .body("userResponse.name", equalTo("John Doe"));
    }

    @Test
    void shouldDenyInvalidRequest() {
        String xml = "<user></user>"; // 缺少必填name字段，预期返回400

        given()
                .contentType("application/xml")
                .body(xml)
                .when()
                .post("/users")
                .then()
                .statusCode(400); // 实际返回200，测试失败
    }
}

问题根源

Spring Boot默认使用MappingJackson2XmlHttpMessageConverter处理XML序列化/反序列化，虽然Jackson的XML模块支持JAXB注解，但它不会自动校验@XmlElement(required = true)这类约束——Jackson的核心是完成数据转换，而非校验字段合法性，所以即使缺少必填字段，它也会把对象反序列化出来（字段值为null），不会抛出异常。

两种解决方案

方案一：改用JAXB原生转换器（严格遵循JAXB注解）

Spring提供了Jaxb2RootElementHttpMessageConverter，它使用JAXB原生的Unmarshaller处理XML反序列化，而JAXB本身会严格校验@XmlElement(required = true)的约束。

步骤：

添加JAXB依赖（JDK11+移除了JAXB模块，需手动引入）：

implementation 'javax.xml.bind:jaxb-api:2.3.1'
implementation 'com.sun.xml.bind:jaxb-impl:2.3.6'
implementation 'com.sun.xml.bind:jaxb-core:2.3.0.1'
implementation 'javax.activation:activation:1.1.1'

配置消息转换器，替换默认的Jackson XML转换器：

package com.example.xmlvalidation;

import org.springframework.context.annotation.Configuration;
import org.springframework.http.converter.HttpMessageConverter;
import org.springframework.http.converter.xml.Jaxb2RootElementHttpMessageConverter;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

import java.util.List;

@Configuration
public class WebConfig implements WebMvcConfigurer {

    @Override
    public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
        // 移除默认的Jackson XML转换器
        converters.removeIf(converter -> converter instanceof org.springframework.http.converter.xml.MappingJackson2XmlHttpMessageConverter);
        // 添加JAXB原生转换器
        converters.add(new Jaxb2RootElementHttpMessageConverter());
    }
}

此时，当请求缺少必填字段时，JAXB的Unmarshaller会抛出UnmarshalException，Spring会自动将其转为400 Bad Request响应，测试即可通过。

方案二：Jackson转换器 + Bean Validation（更灵活的校验）

如果不想切换转换器，可以保留Jackson，同时结合Bean Validation（JSR-380）实现字段校验，这种方式不仅能处理非空约束，还能支持更复杂的校验规则。

步骤：

添加Bean Validation依赖：

implementation 'org.springframework.boot:spring-boot-starter-validation'

修改请求模型，添加@NotNull注解（和JAXB注解配合）：

package com.example.xmlvalidation;

import javax.xml.bind.annotation.XmlElement;
import javax.xml.bind.annotation.XmlRootElement;
import javax.validation.constraints.NotNull;

@XmlRootElement(name = "user")
public class UserRequest {

    private String name;

    @XmlElement(required = true)
    @NotNull(message = "Name is required")
    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }
}

开启控制器校验，在@RequestBody前添加@Valid注解：

@PostMapping(value = "/users", consumes = "application/xml", produces = "application/xml")
public ResponseEntity<UserResponse> createUser(@Valid @RequestBody UserRequest request) {
    // 原有逻辑
}

此时，当请求缺少name字段时，Bean Validation会抛出ConstraintViolationException，Spring自动返回400响应，测试通过。

方案对比

方案一：完全依赖JAXB原生规则，无需额外添加校验注解，适合纯JAXB约束的场景，但需要处理JDK版本的依赖问题。
方案二：更灵活，支持复杂校验规则（如长度、格式等），是Spring Boot中更推荐的通用校验方案。

内容的提问来源于stack exchange，提问作者korolar