接口参数校验在java后端开发中至关重要，掌握validation注解的关键点可提升代码健壮性与维护性。1. 熟悉基本注解如@notblank、@notnull、@min/@max、@size、@email、@pattern，并在controller中通过@valid触发校验；2. 使用分组校验区分不同业务场景，在接口定义分组并通过@validated指定分组实现灵活校验；3. 全局异常处理捕获methodargumentnotvalidexception并封装为统一错误结构，提升用户体验；4. 嵌套对象外层需加@valid才能触发内层校验，确保深层字段也受控。
接口参数校验是Java后端开发中非常基础但也非常容易被忽略的一环。很多人一开始觉得加几个注解就够了，但真正用起来才发现：不是不生效，就是不知道怎么扩展，或者和业务逻辑混在一起不好维护。其实，只要掌握几个关键点，用好Validation注解并不难。
一、基本注解用法要熟悉
Spring Boot默认支持Bean Validation（JSR-380规范），常用的注解包括：
-
@NotBlank：适用于字符串，不能为null或空字符串 -
@NotNull：适用于对象类型，不能为null -
@Min(value)/@Max(value)：数字最小最大值限制 -
@Size(min, max)：集合、数组长度范围控制 -
@Email：邮箱格式校验 -
@Pattern(regexp)：自定义正则表达式匹配
举个例子，一个用户注册的请求体可以这样写：
立即学习“Java免费学习笔记（深入）”；
public class RegisterRequest {
@NotBlank(message = "用户名不能为空")
private String username;
@NotBlank(message = "密码不能为空")
@Size(min = 6, message = "密码至少6位")
private String password;
@Email(message = "邮箱格式不正确")
private String email;
}在Controller里加上@Valid就能触发校验了：
@PostMapping("/register")
public ResponseEntity register(@Valid @RequestBody RegisterRequest request) {
// 业务处理
}不过注意：如果不是在Controller层直接接收参数，比如你在Service里手动构建对象，那这些注解不会自动生效，需要手动调用Validator组件。
二、分组校验让不同场景更灵活
有时候同一个类在不同接口里需要不同的校验规则。例如，新增用户时手机号必填，但修改时可以非必填。这时候就可以用到分组校验（Validation Groups）。
步骤如下：
-
定义两个空接口表示不同分组：
public interface CreateGroup {} public interface UpdateGroup {} -
在实体类字段上指定分组：
public class UserDTO { @NotBlank(groups = {CreateGroup.class}) private String phone; @NotBlank private String name; } -
Controller中使用分组方式校验：
@PostMapping("/user") public void createUser(@Validated(CreateGroup.class) @RequestBody UserDTO userDTO) { // ... }
这种方式特别适合需要区分创建、更新、查询等不同操作的场景，避免把所有字段都设成可选再手动判断。
三、异常统一处理提升用户体验
如果不做统一处理，当参数校验失败时会抛出MethodArgumentNotValidException，返回结果很不友好，甚至暴露内部错误信息。
建议的做法是在全局异常处理器中捕获并封装成统一结构。例如：
@RestControllerAdvice
public class ValidationExceptionHandler {
@ExceptionHandler(MethodArgumentNotValidException.class)
public ResponseEntity> handleValidationExceptions(MethodArgumentNotValidException ex) {
Map errors = new HashMap<>();
ex.getBindingResult().getAllErrors().forEach(error -> {
String fieldName = ((FieldError) error).getField();
String errorMessage = error.getDefaultMessage();
errors.put(fieldName, errorMessage);
});
return ResponseEntity.badRequest().body(errors);
}
} 这样前端收到的是清晰的字段级错误提示，而不是一堆堆栈信息。
四、嵌套对象也要校验别忘了
如果你的请求体里有嵌套的对象，比如下面这个例子：
public class OrderRequest {
@Valid
private List items;
}
public class OrderItem {
@NotBlank
private String productId;
} 要注意一点：外层必须加上@Valid才会触发内层的校验。否则即使OrderItem上有注解也不会生效。
这一点经常被忽略，特别是新手可能会奇怪“为什么里面的字段没校验？”
基本上就这些。Validation注解本身不复杂，但实际使用时有些细节容易踩坑。只要在设计阶段多考虑下分组、异常处理和嵌套对象的问题，就能写出更健壮、易维护的接口校验逻辑。
