Spring项目中idEvent参数存在却转为null的问题排查

结合你遇到的MissingServletRequestParameterException（提示参数存在但转换为null），以下是几个最可能的原因及解决思路：

1. 参数类型不匹配导致转换失败 #

如果前端传递的idEvent值无法转换为你控制器方法中声明的参数类型，Spring会将其设为null，触发必填校验。

• 示例：控制器参数是@RequestParam("idEvent") Long idEvent，但前端传了空字符串""、非数字字符串（比如"abc"），或者格式错误的数字（比如"123.45"），都会导致类型转换失败，最终得到null。
• 排查：在浏览器开发者工具的Network面板里查看请求的实际参数值，确认是否符合后端参数的类型要求。
• 解决：要么前端确保传递合法的数值类型，要么后端调整参数类型（比如先用String接收再手动转换），或者添加@RequestParam(required = true, defaultValue = "")配合自定义校验。

2. 请求参数传递方式与控制器注解不匹配 #

这是最常见的问题：前端传递参数的方式和后端接收的方式不对应，导致Spring无法正确绑定值。

• 场景1：前端用JSON请求体传递参数（比如axios.post('/addUser', {idEvent: 123})），但控制器用@RequestParam接收。@RequestParam是用来获取URL查询参数或form-data参数的，无法直接读取JSON体里的字段。
  • 解决：要么前端把参数放到URL查询参数（比如/addUser?idEvent=123）或form-data中；要么后端改用@RequestBody接收DTO对象（比如@RequestBody EventUserDTO dto，DTO里包含idEvent字段）。
• 场景2：前端用form-data传递，但参数名的编码或格式有问题（比如包含特殊字符），导致Spring解析时丢失值。

3. 数据绑定的隐式转换异常 #

如果你的控制器是通过DTO对象接收参数（比如@ModelAttribute EventUserDTO dto），但DTO中idEvent字段的类型与请求参数不兼容，或者字段的setter方法有问题，也会导致绑定为null。

• 示例：DTO中idEvent是Integer类型，但前端传了超出Integer范围的数值，或者setter方法逻辑错误（比如没有正确赋值）。
• 排查：检查DTO的字段类型、setter方法是否正常，或者在控制器中先单独用@RequestParam接收idEvent，看是否能拿到值，排除DTO绑定的问题。

4. 请求被过滤器/拦截器篡改 #

如果项目中有自定义的过滤器或拦截器，可能在处理请求时修改或清空了idEvent参数值，导致Spring最终拿到的是null。

• 排查：暂时禁用自定义的过滤器/拦截器，测试请求是否正常，逐步排查是哪个组件导致的问题。

5. 参数名的隐性不匹配 #

虽然你确认参数名称一致，但可能存在以下隐性问题：

• 前后端参数名的大小写不一致：Spring的@RequestParam默认是严格匹配大小写的（比如前端传IdEvent，后端是idEvent就会匹配失败）。
• 参数名包含空格或不可见字符：前端传递的参数名可能带有空格，比如"idEvent "，后端是"idEvent"，导致匹配不上。
• 排查：在控制器中打印所有请求参数（比如request.getParameterMap()），确认实际接收到的参数名和值。

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