GET接口使用@RequestBody报HttpMessageNotReadableException解决
问题触发核心原因
从现有代码的配置错配可直接定位异常来源,无需要额外排查的隐藏问题:
- 当前Controller接口用
@GetMapping映射路由,但入参标注了@RequestBody Metrics metrics。HTTP规范中GET请求设计上不携带请求体,SpringMVC处理带@RequestBody的入参时,会强制解析请求体内容,找不到对应内容就会直接抛出HttpMessageNotReadableException,提示“缺少请求体”。报错提示里的“Malformed JSON request”是Spring对这类请求体解析异常的通用归类,并非真的是JSON格式写错。 - 从接口业务逻辑看,这个接口的作用是统计指定API的调用次数,实际需要的入参仅为Metrics类的
name字段,完全不需要通过请求体传输整个实体对象。
对应修复方案
根据实际业务的传参需求选择对应改法:
- 保持GET方法的传参逻辑(和现有接口定义匹配,推荐使用)
- 把原方法里的
@RequestBody Metrics metrics替换为@RequestParam String name,直接从URL查询参数中接收接口名称 - 方法内部手动构建Metrics实例传给Service层,不需要依赖Spring自动反序列化整个实体类
调整后的Controller示例代码:
此时Postman调用时,直接在URL后拼接@ApiOperation("Count of the number of times an API is called") @GetMapping(value="/metrics") @PreAuthorize("hasRole('User')") public ResponseEntity<Metrics> apiCalled(@RequestParam String name){ Metrics metrics = new Metrics(name); return configOpsAPIService.apiCount(metrics); }?name=对应接口名参数即可,不需要额外构造请求体。 - 把原方法里的
- 若后续需要传入多个复杂参数、必须通过请求体传参
- 把接口的HTTP方法从
@GetMapping改为@PostMapping,匹配请求体的使用场景 - 给
@RequestBody加上required = false的兜底配置,避免空请求体直接触发400错误 - Postman调用时,需要手动在请求的Body栏选择raw-JSON格式,填入符合Metrics类结构的JSON内容,不能沿用GET请求的URL拼参方式
- 把接口的HTTP方法从
- 额外排查反序列化隐患
当前Metrics类已经通过@NoArgsConstructor标注了无参构造方法,Jackson可以正常完成反序列化,但要注意success和failure两个HashMap的泛型结构,传入的JSON内容要和声明的HashMap<String, Long>结构完全匹配,否则就算拿到有效请求体,也会触发反序列化报错。
内容的提问来源于stack exchange,提问作者Shreya
相关产品推荐
相关产品推荐

