Spring Boot API中@RequestBody映射为null的问题求助

针对你遇到的@RequestBody无法正确映射DTO的问题，以下是几种常见的排查方向和解决方法：

1. 检查Lombok是否正确生效 #

你的DTO使用了@Data注解，该注解依赖Lombok自动生成getter、setter、toString等方法。如果Lombok未生效，Jackson无法通过反射为字段赋值，导致所有字段为null：

• 确认pom.xml（Maven）或build.gradle（Gradle）中已引入Lombok依赖：
  Maven：

  <dependency>
      <groupId>org.projectlombok</groupId>
      <artifactId>lombok</artifactId>
      <optional>true</optional>
  </dependency>
  

  Gradle：

  compileOnly 'org.projectlombok:lombok'
  annotationProcessor 'org.projectlombok:lombok'
  

• 确认IDE已安装Lombok插件（如IntelliJ IDEA需在Settings > Plugins中搜索安装，并开启Enable annotation processing）。

2. 验证请求体格式与字段匹配 #

Jackson对JSON的字段匹配是大小写敏感的，且要求请求体是标准JSON格式：

• 检查Postman中请求体的键名是否与DTO字段完全一致（例如DTO中是userId，请求体不能写成userid或UserID）。
• 确保请求体是合法JSON，示例格式：

  {
      "userId": 1,
      "productId": 1001
  }
  

  避免出现语法错误（如缺少引号、逗号使用错误等）。

3. 确认请求头与请求类型匹配 #

即使你设置了consumes = MediaType.APPLICATION_JSON_VALUE，仍需确保请求的Content-Type头正确：

• 在Postman的Headers标签中，确认Content-Type的值是application/json，而非multipart/form-data或application/x-www-form-urlencoded（这两种格式的请求体无法被@RequestBody解析为JSON）。
• 可临时在接口中添加请求头打印，验证实际传入的Content-Type：

  @PostMapping("/cart")
  public ResponseEntity<?> addProductToCart(
      @RequestBody AddProductInCartDto addProductInCartDto,
      @RequestHeader("Content-Type") String contentType
  ) {
      System.out.println("Content-Type: " + contentType);
      System.out.println("Received payload: " + addProductInCartDto);
      return ResponseEntity.ok(addProductInCartDto);
  }
  

4. 检查Jackson依赖是否正常 #

Spring Boot的spring-boot-starter-web默认包含Jackson依赖，若依赖缺失或版本冲突，会导致JSON解析失败：

• 确认pom.xml/build.gradle中已引入spring-boot-starter-web依赖：
  Maven：

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
  </dependency>
  

• 若自定义了Jackson配置，检查是否有禁用自动映射或字段过滤的规则（如@JsonIgnore、ObjectMapper的自定义配置）。

5. 调试技巧：直接接收原始请求体 #

将@RequestBody的参数类型改为String，打印原始请求体，排查是否是请求体本身的问题：

@PostMapping("/cart")
public ResponseEntity<?> addProductToCart(@RequestBody String rawBody) {
    System.out.println("Raw request body: " + rawBody);
    // 手动反序列化测试
    ObjectMapper mapper = new ObjectMapper();
    try {
        AddProductInCartDto dto = mapper.readValue(rawBody, AddProductInCartDto.class);
        System.out.println("Deserialized DTO: " + dto);
    } catch (JsonProcessingException e) {
        e.printStackTrace();
    }
    return ResponseEntity.ok(rawBody);
}

如果原始请求体为空或格式错误，说明问题出在请求发送端；如果手动反序列化也失败，说明DTO或Jackson配置有问题。

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