Spring Validation 参数校验实践

zjc 于 2026-08-06 发布

接口参数校验不应该散落在 Service 里写 if。这个项目使用 Jakarta Validation，把规则贴在 DTO 和 Controller 参数上。

@PostMapping("/user")
public ApiResponse<UserDTO> add(@Valid @RequestBody UserDTO dto) {
    ...
}

https://github.com/springvortex/spring-cloud-alibaba/blob/main/service-provider/src/main/java/com/zjc/provider/controller/UserController.java

DTO 字段上声明规则：

@NotBlank(message = "登录账号不能为空")
@Size(min = 3, max = 20, message = "账号长度需在3-20个字符之间")
private String username;

https://github.com/springvortex/spring-cloud-alibaba/blob/main/service-common/src/main/java/com/zjc/common/dto/UserDTO.java

分页参数在 Controller 方法上直接标注：

@Min(value = 1, message = "当前页码必须从1开始")
@RequestParam long current

https://github.com/springvortex/spring-cloud-alibaba/blob/main/service-provider/src/main/java/com/zjc/provider/controller/UserController.java

同时类上要开启：

@Validated

https://github.com/springvortex/spring-cloud-alibaba/blob/main/service-provider/src/main/java/com/zjc/provider/controller/UserController.java

校验失败会抛出不同异常：

公共全局异常处理器统一拦截，把错误字段和消息拼成稳定 ApiResponse。