将javax.validation替换为jakarta.validation后参数校验失效求助

问题核心 #

你的代码里存在一个关键错误：URL中的{type}是路径参数，但你用了@RequestParam注解接收（该注解用于处理?key=value形式的查询参数），不管是javax还是jakarta的校验，这种注解不匹配的情况都会导致参数无法正确绑定，替换为jakarta后校验机制更严格，直接暴露了问题。

修复步骤 #

1. 修正参数接收注解
   将@RequestParam替换为@PathVariable，同时确保@Pattern导入的是jakarta.validation.constraints.Pattern：

@RequestMapping(value = "/v3/{versionId}/start/info/{type}", method = RequestMethod.GET,
    headers = "Content-Type=application/json", produces = "application.json")
public ResponseEntity<Response> getStartInfo(
        @RequestHeader(value = "X-language") String language,
        @PathVariable
        @Pattern(regexp = RegexPattern.TYPE, message = "DBS.280232") String type,
        HttpServletRequest request
) {
    // 业务逻辑实现
}

2. 确保校验功能启用
   在你的Controller类上添加@Validated注解，触发方法级别的参数校验：

@RestController
@Validated // 必须添加此注解才能启用参数校验
public class YourController {
    // 接口方法
}

3. 适配Spring版本

• 若使用Spring Boot 3.x：已全面兼容Jakarta EE规范，无需额外配置；
• 若使用Spring Boot 2.x：需确保spring-boot-starter-validation版本在2.7及以上（该版本开始支持Jakarta校验API），或手动引入jakarta.validation-api依赖。

额外注意事项 #

• 路径参数默认必填，若需type可选，需调整路由规则（如将{type}改为{type:.*}），并给@PathVariable添加required = false（但路径参数可选通常不推荐，建议优先调整接口设计）；
• 校验失败时Spring会抛出ConstraintViolationException，需全局捕获该异常并返回自定义错误响应，示例：

@RestControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(ConstraintViolationException.class)
    public ResponseEntity<Response> handleConstraintViolation(ConstraintViolationException e) {
        String errorMsg = e.getConstraintViolations().stream()
                .map(ConstraintViolation::getMessage)
                .findFirst()
                .orElse("参数校验不通过");
        return ResponseEntity.badRequest().body(new Response(errorMsg));
    }
}

内容的提问来源于stack exchange，提问作者不会说话的鱼