You need to enable JavaScript to run this app. GET接口使用@RequestBody报HttpMessageNotReadableException解决
优惠活动
大模型
产品
解决方案
定价
更多

GET接口使用@RequestBody报HttpMessageNotReadableException解决

问题触发核心原因

从现有代码的配置错配可直接定位异常来源,无需要额外排查的隐藏问题:

  • 当前Controller接口用@GetMapping映射路由,但入参标注了@RequestBody Metrics metrics。HTTP规范中GET请求设计上不携带请求体,SpringMVC处理带@RequestBody的入参时,会强制解析请求体内容,找不到对应内容就会直接抛出HttpMessageNotReadableException,提示“缺少请求体”。报错提示里的“Malformed JSON request”是Spring对这类请求体解析异常的通用归类,并非真的是JSON格式写错。
  • 从接口业务逻辑看,这个接口的作用是统计指定API的调用次数,实际需要的入参仅为Metrics类的name字段,完全不需要通过请求体传输整个实体对象。
对应修复方案

根据实际业务的传参需求选择对应改法:

  1. 保持GET方法的传参逻辑(和现有接口定义匹配,推荐使用)
    • 把原方法里的@RequestBody Metrics metrics替换为@RequestParam String name,直接从URL查询参数中接收接口名称
    • 方法内部手动构建Metrics实例传给Service层,不需要依赖Spring自动反序列化整个实体类
      调整后的Controller示例代码:
    @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);
    }
    
    此时Postman调用时,直接在URL后拼接?name=对应接口名参数即可,不需要额外构造请求体。
  2. 若后续需要传入多个复杂参数、必须通过请求体传参
    • 把接口的HTTP方法从@GetMapping改为@PostMapping,匹配请求体的使用场景
    • 给@RequestBody加上required = false的兜底配置,避免空请求体直接触发400错误
    • Postman调用时,需要手动在请求的Body栏选择raw-JSON格式,填入符合Metrics类结构的JSON内容,不能沿用GET请求的URL拼参方式
  3. 额外排查反序列化隐患
    当前Metrics类已经通过@NoArgsConstructor标注了无参构造方法,Jackson可以正常完成反序列化,但要注意success和failure两个HashMap的泛型结构,传入的JSON内容要和声明的HashMap<String, Long>结构完全匹配,否则就算拿到有效请求体,也会触发反序列化报错。

内容的提问来源于stack exchange,提问作者Shreya

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.06 20:06:03