为何仅使用@PropertySource时SpringBoot参数验证不生效？

核心原因 #

@PropertySource + @Value的组合不会触发Spring的自动参数验证逻辑，而@ConfigurationProperties的属性绑定流程内置了验证触发机制，这是两者的本质区别。

详细拆解 #

1. @PropertySource仅负责加载配置，不参与验证
   @PropertySource的作用只是将指定配置文件（比如你的person.yaml）中的键值对加载到Spring的Environment中，它不处理后续的属性注入和验证工作，也不会主动触发任何验证逻辑。

2. @Value注入无验证环节
   @Value是直接从Environment中取值并赋值给字段，这个过程由Spring的Bean后置处理器完成，仅做值的注入，不会扫描字段上的@Max、@Email等JSR-380验证注解，自然不会执行验证。

3. @Validated在该场景下不作用于字段注入
   类上的@Validated注解默认是用来验证方法参数的（比如Controller接口参数、@Bean方法的参数），不会对@Value注入的字段值进行验证。Spring默认没有为字段注入场景绑定验证逻辑。

4. @ConfigurationProperties内置验证流程
   @ConfigurationProperties是Spring专门为外部配置绑定Bean设计的注解，其内部的ConfigurationPropertiesBinder在完成属性绑定后，会自动检查Bean上的@Validated注解以及字段上的验证规则，执行验证逻辑，一旦验证失败就会抛出异常，阻止项目启动。

解决方案（若坚持使用@PropertySource + @Value） #

如果必须用@PropertySource加载配置并通过@Value注入，可以手动触发验证，比如实现InitializingBean接口，在Bean初始化完成后手动调用验证器：

@Component
@Validated
@PropertySource(value = "classpath:person.yaml")
@Data
public class Person implements InitializingBean {
    @NotNull(message = "test can't be null")
    private String test;
    @Value("${name}")
    private String name;
    @Autowired
    private Cat pet;
    @Max(value=120,message="invalid age")
    @Value("${age}")
    private int age;

    @Email(message = "invalid email address")
    @Value("${email}")
    private String email;

    @Autowired
    private Validator validator;

    @Override
    public void afterPropertiesSet() throws Exception {
        Set<ConstraintViolation<Person>> violations = validator.validate(this);
        if (!violations.isEmpty()) {
            throw new ConstraintViolationException(violations);
        }
    }
}

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