SpringBoot中@RequestParam缺失异常无法被父类异常处理器捕获问题

核心原因 #

该问题几乎都是异常类型匹配失败或异常处理器优先级不足导致的，常见的触发场景如下：

• Spring Boot 3+版本全面迁移到Jakarta EE，如果你项目中导入的异常类还是javax.servlet包下的，和实际抛出的jakarta.servlet包下的异常类型完全不匹配，自然无法触发处理逻辑
• DELETE请求的参数绑定阶段抛出的异常可能不是你预设的两个子类，而是更上层的ServletRequestBindingException父类
• 项目中存在@RestControllerAdvice注解的全局异常处理器，默认优先级高于Controller层级的局部异常处理器，导致父类的异常处理逻辑被覆盖

解决步骤 #

第一步：确认实际抛出的异常类型 #

先在BaseController中新增临时的全局异常捕获逻辑，打印异常的全类名，确认缺省id参数时的真实异常：

@ExceptionHandler(Exception.class)
public ResponseEntity<Map<String, Object>> handleTestException(Exception e) {
    // 打印异常全类名和栈信息，确认实际类型
    System.out.println("实际抛出异常类：" + e.getClass().getName());
    e.printStackTrace();
    Map<String, Object> res = new HashMap<>();
    res.put("code", 400);
    res.put("msg", e.getMessage());
    return ResponseEntity.badRequest().body(res);
}

第二步：针对性修复 #

根据第一步拿到的异常类型做对应调整：

1. 包名不匹配修复
   如果是Spring Boot 3+项目，把所有Servlet相关异常的导入包从javax.servlet替换为jakarta.servlet即可。
2. 异常匹配范围调整
   把原异常处理器的捕获类型调整为父类ServletRequestBindingException，可以覆盖所有参数绑定相关的异常，包含你原来配置的两个子类：

// Spring Boot 2.x用javax.servlet.ServletRequestBindingException
import jakarta.servlet.ServletRequestBindingException;

@ExceptionHandler(ServletRequestBindingException.class)
public ResponseEntity<Map<String, Object>> handleParamError(ServletRequestBindingException e) {
    Map<String, Object> result = new HashMap<>();
    result.put("code", 400);
    result.put("message", "请求参数非法：" + e.getMessage());
    return ResponseEntity.status(400).body(result);
}

3. 优先级调整
   如果项目中存在全局异常处理器，有两种方案可选：

• 把参数相关的异常处理逻辑挪到全局异常处理器中
• 给BaseController添加@Order(Ordered.HIGHEST_PRECEDENCE)注解，提升局部异常处理器的优先级

验证方法 #

可以新增一个相同参数配置的@GetMapping测试接口，缺省参数时如果能正常被捕获，即可确认是DELETE请求的异常类型匹配问题，按上述步骤调整即可。

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