Spring Boot 中参数校验综合实战项目怎么做-java教程-PHP中文网

spring boot接口参数校验三步走：加spring-boot-starter-validation依赖；在dto字段用@notblank、@email等注解声明规则；controller参数加@valid触发校验，再用@restcontrolleradvice统一处理异常返回结构化错误。

spring boot 中参数校验综合实战项目怎么做

直接上手做，核心就三件事：加依赖、写校验规则、统一处理错误。不绕弯子，也不堆概念。

第一步：引入校验能力

Spring Boot 2.3+ 版本起，spring-boot-starter-validation 不再自动包含在 web starter 里，必须显式添加：

在 pom.xml 中加入：

org.springframework.boot
spring-boot-starter-validation

加完就能用 @NotBlank、@Min、@Email 这些注解了，无需额外配置。

第二步：DTO 里写清楚要校什么

别在校验逻辑里写 if-else，把规则“贴”在字段上。比如用户注册 DTO：

@NotBlank(message = "用户名不能为空") —— 字符串非空且去空格后长度 > 0
@Email(message = "邮箱格式不正确") —— 自动校验邮箱结构
@Pattern(regexp = "^1[3-9]\d{9}$", message = "手机号格式错误") —— 自定义正则
@Min(value = 18, message = "年龄不能小于18岁") —— 数值范围控制

注意：@NotNull 允许空字符串，@NotEmpty 拒绝空集合/空字符串，选错容易踩坑。

第三步：Controller 层触发校验

在接口参数上加 @Valid 或 @Validated：

JavaStoryDevelop

你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在

下载

@RequestBody @Valid UserRegisterDTO dto —— 用于 JSON 请求体
@PathVariable @Min(1) Long id —— 路径变量也能校
@RequestParam @NotBlank String name —— 查询参数同样支持

校验失败时，Spring 会自动抛出 MethodArgumentNotValidException（请求体）或 ConstraintViolationException（路径/查询参数），不用手动 catch。

第四步：全局拦截错误，返回统一格式

建一个异常处理器类，用 @RestControllerAdvice 拦住所有校验异常：

捕获 MethodArgumentNotValidException，提取每个字段的错误信息，组装成 {"code":400,"msg":"用户名不能为空","details":[{"field":"username","reason":"不能为空"}]}
捕获 ConstraintViolationException，处理 @PathVariable 和 @RequestParam 的报错
顺便把 NullPointerException、IllegalArgumentException 等也兜底一下，避免 500 泄露堆栈

这样前端收到的永远是结构清晰的错误响应，不需要每个接口自己写 BindingResult 判断。