如何用Spring Validator校验嵌套POJO？遇IllegalArgumentException异常

你遇到的问题是Spring的SpringValidatorAdapter处理Jakarta Validation嵌套校验错误时，SimpleErrors无法正确访问嵌套对象的属性值。核心原因是SimpleErrors的属性访问逻辑较为简陋：它优先尝试直接访问public字段，失败后才会调用getter方法，但在部分场景下（比如类在默认包下、反射权限限制），无法正确识别并调用getter方法。

解决方案 #

1. 用BeanPropertyBindingResult替代SimpleErrors

BeanPropertyBindingResult是Spring推荐的JavaBean校验Errors实现，它基于BeanWrapper机制，能严格遵循JavaBean规范识别getter方法，即使字段是private的也能正常访问。

修改测试代码如下：

@Test
public void testInvalidEmailAddress() {
    Person person = new Person();
    EmailAddress email = new EmailAddress("invalid");
    person.setEmail(email);

    // 替换为BeanPropertyBindingResult
    Errors errors = new BeanPropertyBindingResult(person, "person");
    validator.validate(person, errors);
    assertEquals(1, errors.getErrorCount());
}

2. 确保POJO类放在具体包下

不要将EmailAddress和Person放在默认包（无包声明）下，JVM对默认包下的类存在反射访问权限限制，可能导致Spring无法调用类的getter方法。将类移动到具体的包（比如com.example.model）即可规避这类问题。

3. 可选：将校验注解移至getter方法

虽然不是必须，但把@Email注解移到getValue()方法上，可以明确告诉校验框架校验的是getter返回的值，而非字段本身，能避免一些潜在的反射访问问题：

public class EmailAddress {
    
    private final String value;

    public EmailAddress(String value) {
        this.value = value;
    }

    @Email // 移至getter方法
    public String getValue() {
        return value;
    }
}

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