Spring Boot中使用Jackson验证含@XmlElement注解的JSON数据最优方法

核心思路：Jackson的JaxbAnnotationModule本身就能识别@XmlElement(required = true)注解，但需要配合Bean Validation和Jackson的反序列化配置才能触发必填项验证，步骤如下：

1. 补全必要依赖 #

Spring Boot 2.7.1版本下，需要确保引入Bean Validation和Jackson的JAXB注解模块依赖（如果项目没自动包含的话）：

<!-- Bean Validation核心依赖 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-validation</artifactId>
</dependency>
<!-- Jackson识别JAXB注解的模块 -->
<dependency>
    <groupId>com.fasterxml.jackson.module</groupId>
    <artifactId>jackson-module-jaxb-annotations</artifactId>
</dependency>

2. 正确配置Jackson #

你之前写的JaxbAnnotationModule Bean是对的，但还需要开启Jackson的反序列化严格模式，让它识别required=true的约束：

方式一：通过配置类自定义ObjectMapper #

@Configuration
public class JacksonConfig {
    @Bean
    public ObjectMapper objectMapper() {
        ObjectMapper mapper = new ObjectMapper();
        // 注册JAXB注解解析模块
        mapper.registerModule(new JaxbAnnotationModule());
        // 开启必填属性缺失时的反序列化失败
        mapper.enable(DeserializationFeature.FAIL_ON_MISSING_CREATOR_PROPERTIES);
        // 开启基本类型为null时的反序列化失败（可选，根据XSD需求调整）
        mapper.enable(DeserializationFeature.FAIL_ON_NULL_FOR_PRIMITIVES);
        return mapper;
    }
}

方式二：用Spring Boot自动配置+配置文件 #

保留你原来的JaxbAnnotationModule Bean，然后在application.properties里加配置：

# 缺失必填属性时抛出异常
spring.jackson.deserialization.fail-on-missing-creator-properties=true
# 基本类型字段为null时抛出异常（可选）
spring.jackson.deserialization.fail-on-null-for-primitives=true

3. 触发验证 #

场景一：Controller接收请求 #

直接在请求体参数上加@Valid注解，Spring会自动触发验证，缺失必填项时会抛出MethodArgumentNotValidException：

@PostMapping("/your-api")
public ResponseEntity<?> handleRequest(@Valid @RequestBody YourXjcGeneratedClass request) {
    // 业务逻辑
    return ResponseEntity.ok("处理成功");
}

场景二：手动反序列化 #

如果是自己手动调用Jackson反序列化，需要用Validator手动验证：

@Autowired
private Validator validator;

public void parseAndValidate(String json) throws JsonProcessingException {
    ObjectMapper mapper = new ObjectMapper();
    mapper.registerModule(new JaxbAnnotationModule());
    YourXjcGeneratedClass obj = mapper.readValue(json, YourXjcGeneratedClass.class);
    
    // 执行验证
    Set<ConstraintViolation<YourXjcGeneratedClass>> violations = validator.validate(obj);
    if (!violations.isEmpty()) {
        throw new ConstraintViolationException(violations);
    }
}

为什么之前的尝试可能没生效？ #

大概率是没开启Jackson的FAIL_ON_MISSING_CREATOR_PROPERTIES配置，或者没引入Bean Validation依赖，导致@XmlElement(required=true)的约束没被真正触发验证。

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