java封装校验注解需结合spring boot等框架触发自动校验：controller层用@valid+@requestbody实现请求参数校验，失败返回400；支持分组校验、service层手动校验及@controlleradvice统一处理异常。
Java 中封装属性校验注解（如 @NotNull、@Size、@Email 等）本身只是元数据，不执行校验逻辑；要实现自动校验，必须结合支持 Bean Validation 规范的框架（如 Spring Boot），并在合适的位置触发校验流程。
Spring Boot + Hibernate Validator 自动校验请求参数
Spring Boot 默认集成 Hibernate Validator（JSR 303/380 实现），可对 Controller 层入参自动校验：
- 在 DTO 类字段上添加校验注解（如
@NotBlank、@Min(1)） - Controller 方法参数前加
@Valid（或@Validated） - 配合
@RequestBody或@ModelAttribute使用，Spring 会自动触发校验 - 校验失败默认返回 400 Bad Request，并携带错误信息（可通过全局异常处理器统一处理）
示例：
public class UserDTO {<br> @NotBlank(message = "用户名不能为空")<br> private String username;<br><br> @Email(message = "邮箱格式不正确")<br> private String email;<br>}
@PostMapping("/users")<br>public Result createUser(@Valid @RequestBody UserDTO dto) {<br> return service.save(dto);<br>}
自定义分组校验控制校验时机
同一字段在不同场景下校验规则可能不同（如新增时要求密码，更新时不校验密码），可用校验分组解决：
- 定义空接口作为分组标记（如
CreateGroup、UpdateGroup） - 注解上指定
groups属性（如@NotBlank(groups = CreateGroup.class)） - Controller 中用
@Validated({CreateGroup.class})显式指定分组
Service 层手动触发校验（非自动，但更灵活）
当校验需嵌入业务逻辑、或跨多个对象、或不在 Web 层时，可手动调用 Validator：
- 注入
javax.validation.Validator（Spring 自动配置） - 调用
validator.validate(object)获取Set<constraintviolation></constraintviolation> - 遍历结果并抛出自定义异常（如
BusinessException）或记录日志
全局异常统一处理校验错误
避免每个接口都 try-catch，推荐用 @ControllerAdvice 捕获 MethodArgumentNotValidException（@RequestBody 校验失败）和 ConstraintViolationException（手动校验或 @Validated 在方法参数上）：
- 提取错误字段名、提示消息，组装成标准响应体（如
{"code":400,"msg":"参数错误","details":[{"field":"email","message":"邮箱格式不正确"}]}） - 注意区分两种异常的获取方式：
BindingResultvsConstraintViolation
不复杂但容易忽略的是：校验注解只对 public 字段或 getter 方法生效（默认按 JavaBean 规范），且必须确保类被 Spring 管理或显式交由 Validator 处理，否则注解不会起作用。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
