当前位置：首页 > news >正文

@Valid和@Vlidated的区别

news 2025/7/19 23:47:35

@Valid 和 @Validated 注解的对比总结

1. 依赖关系

注解

依赖库/框架

额外配置要求

@Valid

JSR-380 (Bean Validation API)

仅需引入 javax.validation

或 Jakarta 规范实现（如 Hibernate Validator）

@Validated

Spring Framework

需 Spring Context 支持（通常通过 spring-boot-starter-validation

隐式引入）

2. 多种用法

@Valid 的典型场景

Controller 层参数校验（最常用）：

java@PostMapping("/login")
public Result<String> login(@Valid @RequestBody LoginDTO loginDTO) {// 自动校验 LoginDTO 字段
}

- 触发条件：仅需在参数上添加 @Valid，Spring MVC 通过 RequestResponseBodyMethodProcessor 自动处理校验。

嵌套对象校验：

javapublic class OrderDTO {@Validprivate UserDTO user; // 嵌套校验 UserDTO 的字段
}

@Validated 的典型场景

Service 层方法校验：

java@Service
@Validated // 必须添加在类上
public class UserService {public void createUser(@Valid UserDTO userDTO) {// 自动校验 UserDTO}
}

分组校验：

javapublic interface UpdateGroup {}@Data
public class UserDTO {@NotNull(groups = UpdateGroup.class)private Long id;
}@RestController
@Validated // 必须添加在类上
public class UserController {@PutMappingpublic Result<?> update(@Validated(UpdateGroup.class) UserDTO dto) {// 仅校验 UpdateGroup 分组的规则}
}

自定义校验逻辑（如 AOP）：

java@Service
@Validated
public class OrderService {@CustomCheck // 自定义校验注解public void processOrder(OrderDTO order) {// 自定义校验逻辑通过 AOP 触发}
}

3. 核心区别

特性	@Valid	@Validated
作用层级	字段/方法参数级别（JSR-380 标准）	类/方法级别（Spring 扩展）
触发场景	显式注解即可触发	需在类/方法上声明
分组校验	❌ 不支持	✅ 支持（需配合 `groups` 属性）
嵌套校验	✅ 支持	✅ 支持
依赖要求	仅需 Bean Validation API	需 Spring Context 支持
Service 层使用	❌ 无法直接触发	✅ 必须通过 `@Validated` 注解类
自定义校验	❌ 需手动实现	✅ 支持（通过 AOP 或方法拦截）

4. 最佳实践

Controller 层：

- 对 @RequestBody 参数使用 @Valid，无需添加 @Validated。
- 示例：

java@PostMapping("/login")
public Result<String> login(@Valid @RequestBody LoginDTO loginDTO) {// ...
}

Service 层：

- 如果需要校验方法参数，必须在类上添加 @Validated。
- 示例：

java@Service
@Validated
public class UserService {public void createUser(@Valid UserDTO userDTO) {// ...}
}

分组校验：

- 必须使用 @Validated 并指定分组类。
- 示例：

java@PutMapping
public Result<?> update(@Validated(UpdateGroup.class) UserDTO dto) {}

5. 验证流程对比

场景	触发校验的关键因素
@RequestBody + @Valid	Spring MVC 内置处理器自动触发
Service 层方法	`@Validated` 注解类 + `@Valid` 参数
分组校验	`@Validated(group)` + `@Valid` 参数