在Spring Boot开发REST API的过程中，缺少请求体的报错是接口调试阶段非常常见的问题，很多开发者遇到这类报错时不知道从何处入手排查。下面我们结合实际场景，一步步梳理问题的排查思路和解决方法。
第一步：确认请求是否真的携带了请求体
首先需要排除是请求发送端的问题，很多时候报错提示缺少请求体，实际是请求根本没带对应的内容。我们可以通过以下两种方式来确认：
- 查看应用的后台请求日志，Spring Boot默认会打印接收到的请求信息，确认请求方法和路径是否正确，是否有请求体内容被打印出来。
- 使用Postman或者curl命令发送测试请求，检查请求体是否正常传递。比如发送一个POST请求到测试接口，携带JSON格式的请求体：
curl -X POST http://127.0.0.1:8080/test/api \
-H "Content-Type: application/json" \
-d '{"name":"test","age":18}'第二步：检查接口的参数注解使用是否正确
如果请求确实携带了请求体，接下来要检查Controller层的接口定义是否正确。Spring Boot中接收请求体需要使用@RequestBody注解，否则框架无法把请求体的内容绑定到方法参数上。
以下是正确和错误的写法对比：
| 场景 | 代码示例 | 结果 |
|---|---|---|
| 正确写法 | public String test(@RequestBody User user) | 正常接收请求体并绑定参数 |
| 错误写法1 | public String test(User user) | 缺少@RequestBody，无法绑定请求体，提示缺少请求体 |
| 错误写法2 | public String test(@RequestParam User user) | @RequestParam用于接收URL参数，无法接收请求体 |
第三步：检查请求头和请求体格式是否匹配
请求头中的Content-Type需要和请求体的格式匹配，否则Spring Boot的消息转换器无法正确解析请求体内容。
- 如果请求体是JSON格式，需要设置
Content-Type: application/json，否则框架会认为请求没有合法的请求体。 - 如果请求体是表单格式，需要设置
Content-Type: application/x-www-form-urlencoded，同时使用@ModelAttribute或者不使用注解来接收参数，而不是@RequestBody。
以下是一个JSON请求体对应的正确接口示例：
@RestController
public class TestController {
// 接收JSON格式的请求体
@PostMapping("/test/api")
public String testApi(@RequestBody User user) {
return "接收到的用户姓名：" + user.getName() + "，年龄：" + user.getAge();
}
// 内部用户实体类
static class User {
private String name;
private Integer age;
// getter和setter方法
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public Integer getAge() {
return age;
}
public void setAge(Integer age) {
this.age = age;
}
}
}第四步：检查请求体内容是否符合参数绑定要求
如果注解和请求头都没问题，还要检查请求体的内容是否能正确绑定到对应的实体类上：
- 实体类的属性需要有对应的getter和setter方法，否则框架无法完成属性赋值。
- 请求体中的字段名需要和实体类的属性名一致，或者通过
@JsonProperty注解指定映射关系，否则对应字段会绑定为null，极端情况下如果实体类没有无参构造器，也可能导致解析失败。 - 如果请求体是空对象
{}，而接口参数要求必须非null，也会提示缺少请求体的相关报错，可以在参数前加@Valid注解配合校验注解来明确校验规则。
import javax.validation.Valid;
import javax.validation.constraints.NotNull;
@RestController
public class TestController {
@PostMapping("/test/api")
public String testApi(@Valid @RequestBody User user) {
return "接收到的用户姓名：" + user.getName() + "，年龄：" + user.getAge();
}
static class User {
@NotNull(message = "姓名不能为空")
private String name;
@NotNull(message = "年龄不能为空")
private Integer age;
// getter和setter
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public Integer getAge() {
return age;
}
public void setAge(Integer age) {
this.age = age;
}
}
}常见特殊场景排查
还有一些特殊情况也会导致缺少请求体的报错：
- 使用了过滤器或者拦截器，在请求到达Controller之前把请求体内容读取并消耗掉了，后面的接口就无法再获取到请求体，这种情况下需要把请求体缓存起来，比如使用ContentCachingRequestWrapper来包装请求。
- 请求方法是GET，GET请求一般不建议携带请求体，部分客户端或者服务器会直接忽略GET请求的请求体，导致接口接收不到内容，如果需要传参，建议使用POST方法。
按照以上步骤逐步排查，基本可以解决Spring Boot REST API提示缺少请求体的绝大多数问题，开发过程中也可以多在接口入口处打印请求相关信息，方便快速定位问题。
Spring_BootREST_API请求体缺失参数校验HTTP请求修改时间：2026-05-30 23:32:45