Spring Rest Controller同时传请求体与路径变量时路径变量校验失效求助

核心原因：缺少触发方法级别校验的注解 #

Spring MVC中，@PathVariable的校验不会自动生效，必须通过@Validated注解（来自org.springframework.validation.annotation.Validated）来触发方法参数的校验逻辑。你当前的代码仅使用了@Valid，但@Valid主要用于@RequestBody的嵌套对象校验或JPA实体校验，无法触发路径变量的校验。

解决步骤 #

1. 添加@Validated注解
   在Controller类或目标方法上添加@Validated，推荐加在类上，这样整个类的方法参数校验都会被触发。同时可以去掉@PathVariable前的@Valid，因为它对路径变量校验无意义：

   @RestController
   @Validated
   public class YourController {
       @PostMapping(value = "/myapi/{id}", produces = APPLICATION_JSON_VALUE, consumes = APPLICATION_JSON_VALUE)
       public ResponseEntity<MyEntity> myApi(
               @NotBlank @PathVariable("id") String id,
               @Valid @RequestBody MyRequestPayload myRequestPayload) throws Exception {
           LOGGER.info("Id is {}",id);
           // 业务逻辑
       }
   }
   

2. 校验注解包检查
   确保@NotBlank导入的是正确的包：

   • Java EE环境：javax.validation.constraints.NotBlank
   • Jakarta EE 9+环境：jakarta.validation.constraints.NotBlank
     导入错误包会导致校验规则完全失效。

3. 处理校验失败异常
   校验不通过时，Spring会抛出ConstraintViolationException，如果没有异常处理器，默认返回500错误，容易让你误以为校验未触发。可以添加全局异常处理器返回友好响应：

   @RestControllerAdvice
   public class GlobalExceptionHandler {
       @ExceptionHandler(ConstraintViolationException.class)
       public ResponseEntity<Map<String, String>> handleConstraintViolation(ConstraintViolationException ex) {
           Map<String, String> errors = new HashMap<>();
           ex.getConstraintViolations().forEach(violation -> {
               String paramName = violation.getPropertyPath().toString();
               errors.put(paramName, violation.getMessage());
           });
           return new ResponseEntity<>(errors, HttpStatus.BAD_REQUEST);
       }
   }
   

额外说明 #

如果请求路径是/myapi/（完全缺失id部分），Spring MVC不会匹配到/myapi/{id}端点，直接返回404。只有当路径传入空字符串（如/myapi/）或空白字符（如/myapi/%20）时，才会触发@NotBlank的校验逻辑。

内容的提问来源于stack exchange，提问作者Sandy