Spring中@Valid与@Validated用法及@Valid失效问题咨询

先给你明确核心结论：@Valid是JSR-303（Bean Validation）的标准注解，而@Validated是Spring对标准的扩展增强。两者的触发逻辑和适用场景有明显区别，这正是你遇到问题的根源。

一、核心差异梳理 #

二、你的问题具体分析 #

1. 配置文件（application.yml）验证场景 #

你提到用@Validated时配置约束能触发，但@Valid不行——这是Spring配置绑定的设计规则：
Spring Boot的@ConfigurationProperties配合验证时，必须用@Validated来标记配置类，因为Spring的配置绑定模块只识别@Validated来触发配置属性的验证逻辑，@Valid在这里不生效。

2. 参数/构造器上@Valid未触发的原因 #

• 普通Service方法参数：Spring默认不会为@Valid标注的参数触发验证，因为@Valid本身没有绑定Spring的验证AOP切面。只有当你在Service类上标注@Validated后，Spring才会为该类的方法参数开启验证，这时候参数上的@Valid（或直接的约束注解）才会生效。
• 构造器参数：JSR-303规范本身支持构造器验证，但Spring默认不会自动触发。要让构造器上的@Valid生效，你需要手动调用Validator的API（比如validateConstructorParameters），或者通过配置LocalValidatorFactoryBean来开启构造器验证的自动触发。

三、@Valid的正确使用场景 #

1. Spring MVC请求体验证 #

这是@Valid最常用的场景：在控制器的请求体参数前标注@Valid，Spring MVC会自动触发Bean Validation，验证请求体的字段约束：

@PostMapping("/users")
public ResponseEntity<User> createUser(@RequestBody @Valid User user) {
    // 验证通过才会进入方法体，否则抛出MethodArgumentNotValidException
    userService.save(user);
    return ResponseEntity.ok(user);
}

2. 嵌套对象验证 #

当你的实体类包含另一个需要验证的嵌套对象时，必须在嵌套字段上标注@Valid，否则外层验证不会触发内层对象的约束检查：

public class Order {
    @NotBlank(message = "订单ID不能为空")
    private String orderId;
    
    @Valid // 必须加这个注解，才会验证buyer对象的约束
    @NotNull(message = "买家信息不能为空")
    private User buyer;
}

// 控制器中验证Order时，会同时验证buyer的字段
@PostMapping("/orders")
public ResponseEntity<Void> createOrder(@RequestBody @Valid Order order) {
    // ...
}

3. JPA实体的嵌套关联验证 #

如果你用JPA保存包含关联实体的对象，在关联字段上标注@Valid可以触发关联实体的验证（部分JPA实现如Hibernate会自动支持）：

@Entity
public class Order {
    @Id
    private Long id;
    
    @Valid
    @OneToOne(cascade = CascadeType.PERSIST)
    private User buyer;
}

四、解决你当前问题的方案 #

1. 配置文件验证：继续使用@Validated + @ConfigurationProperties，这是Spring官方推荐的配置验证方式。
2. Service方法参数验证：在Service类上添加@Validated，然后在需要验证的参数上标注@Valid（或直接的约束注解）：

   @Validated // 必须加在类上
   @Service
   public class UserService {
       public void saveUser(@Valid User user) {
           // 这里会触发user对象的验证
       }
   }
   

3. 构造器验证：手动调用Validator API实现验证：

   @Autowired
   private Validator validator;
   
   public User createUser(String username, String email) {
       Constructor<User> constructor = User.class.getConstructor(String.class, String.class);
       Set<ConstraintViolation<User>> violations = validator.validateConstructorParameters(constructor, new Object[]{username, email});
       if (!violations.isEmpty()) {
           throw new ConstraintViolationException(violations);
       }
       return new User(username, email);
   }
   

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