java中get请求的query参数不能直接用@validated校验@requestparam，必须封装为dto并配合@modelattribute+@validated；否则校验无效。
Java 中 GET 请求的 Query 参数不能直接用 @Validated 注解在方法参数上生效，因为 Spring MVC 默认不会对普通参数（如 @RequestParam）自动触发 Bean Validation。必须借助包装对象（DTO）+ @Validated + @ModelAttribute 或自定义参数解析器才能实现校验。
用 DTO 包装 Query 参数并配合 @ModelAttribute
这是最常用、最推荐的方式：把多个 Query 参数封装成一个 DTO 类，在 Controller 方法中用 @ModelAttribute + @Validated 组合触发校验。
- 定义校验 DTO（注意添加
public无参构造、getter/setter）：
public class UserQuery {
@NotBlank(message = "username 不能为空")
private String username;
<pre class="brush:java;toolbar:false;">@Min(value = 1, message = "page 必须大于等于 1")
private Integer page = 1;
@Max(value = 100, message = "size 不能超过 100")
private Integer size = 10;
// getter / setter 省略}
- Controller 方法中使用
@Validated+@ModelAttribute：
@GetMapping("/users")
public List<user> listUsers(@Validated @ModelAttribute UserQuery query) {
return userService.list(query);
}</user>
- Spring 会自动将 URL 中的 query string（如
?username=abc&page=2）绑定到UserQuery实例，并执行校验；校验失败时抛出MethodArgumentNotValidException，可全局捕获返回 400。
不推荐：试图直接在 @RequestParam 上加 @Validated
以下写法无效，Spring 不支持：
// ❌ 错误！@Validated 对单个 @RequestParam 不起作用
@GetMapping("/users")
public List<user> list(@Validated @RequestParam String username) { ... }</user>
-
@RequestParam是基础类型或简单对象，没有嵌套结构，JSR-303 校验器无法介入绑定流程 - 即使加了
@Validated，也不会触发校验逻辑，相当于被忽略
进阶：自定义 HandlerMethodArgumentResolver 支持 @RequestParam 校验
如果坚持用扁平化参数（如多个独立 @RequestParam），可通过自定义参数解析器实现，但成本高、易出错，仅适合特殊场景。
- 需继承
HandlerMethodArgumentResolver，重写resolveArgument - 手动提取请求参数 → 构建临时对象 → 调用
Validator.validate() - 需注册到
WebMvcConfigurer.addArgumentResolvers() - 实际项目中极少采用，维护性和可读性差
全局处理校验失败（补充）
为统一返回格式，建议添加全局异常处理器：
@RestControllerAdvice
public class ValidationExceptionHandler {
<pre class="brush:java;toolbar:false;">@ResponseStatus(HttpStatus.BAD_REQUEST)
@ExceptionHandler(MethodArgumentNotValidException.class)
public Map<String, String> handleValidationExceptions(
MethodArgumentNotValidException ex) {
Map<String, String> errors = new HashMap<>();
ex.getBindingResult().getAllErrors().forEach((error) -> {
String fieldName = ((FieldError) error).getField();
String errorMessage = error.getDefaultMessage();
errors.put(fieldName, errorMessage);
});
return errors;
}}
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
