最推荐直接捕获MissingServletRequestParameterException：该异常专指@RequestParam（required=true）或@PathVariable必需参数缺失，应通过@ExceptionHandler精确处理并返回含parameterName的友好提示，避免用Exception兜底。
直接捕获 MissingServletRequestParameterException，并返回前端友好的错误提示，是最精准、最推荐的做法。
明确捕获 MissingServletRequestParameterException
这个异常专指客户端请求中缺失了被 @RequestParam（且 required = true）或 @PathVariable 修饰的必需参数。不建议用泛化的 Exception.class 来兜底处理，否则会掩盖真正的问题类型，也难以给出针对性提示。
- 在全局异常处理器类（标注
@RestControllerAdvice）中，添加一个专门处理该异常的方法 - 使用
@ExceptionHandler(MissingServletRequestParameterException.class)注解绑定 - 方法内可直接从异常对象中获取缺失参数名：
exception.getParameterName() - 返回统一的
Result或ApiResponse格式，例如：Result.error(400, "缺少必需参数：" + paramName)
区分参数类型，提供清晰反馈
同一个异常类可能由不同来源的参数缺失触发，但用户需要知道“缺的是 URL 上的？还是路径里的？还是表单提交的？”。虽然异常本身不直接区分，但你可以结合上下文辅助判断：
- 如果请求是 GET 且带查询字符串（如
/api/user?id=123），而报错提示缺name，大概率是查询参数缺失 - 如果请求是 GET 且路径含变量（如
/api/user/{id}），却提示缺id，说明路径变量未传入或格式错误 - 如果是 POST 表单提交，缺的是表单字段名，需确认前端
<input name="xxx">的 name 是否与后端@RequestParam("xxx")一致
避免问题比处理更重要：提前防御
光靠异常处理是被动补救。更高效的方式是在设计和开发阶段就减少这类异常发生的可能：
- 对非关键参数，显式设置
@RequestParam(required = false)，并提供默认值（defaultValue = "xxx"） - 前端调用接口前，做必填校验；API 文档中明确标注哪些参数为 required
- 后端 Controller 方法参数命名尽量与前端约定一致，避免因大小写、下划线等差异导致绑定失败
- 调试时开启 Spring Boot 的 debug 日志（
logging.level.org.springframework.web=DEBUG），能清楚看到参数解析过程
补充：别忽略 URL 编码和空格问题
有时参数“明明传了”，却仍报缺失异常，常见于：
- 前端拼接 URL 时，参数值含空格、中文、特殊符号，但未做
encodeURIComponent()编码 - 后端接收时，Spring 默认只解码一次，若前端多编码了一次，可能导致参数值为空字符串，被判定为“缺失”
- 检查浏览器开发者工具 Network 面板中的实际请求 URL 和 Query String，确认参数是否真实存在且可读
