Spring Boot Rest客户端调用时DTO属性为null的问题解决问询

我之前也碰到过完全一样的情况——MVC表单提交正常，但REST接口收不到JSON参数，DTO全是null还触发空指针。咱们一步步来定位解决：

1. 最可能的原因：Controller接口缺失@RequestBody注解 #

Spring MVC处理Thymeleaf表单提交时，是通过表单字段名和DTO属性名绑定的，不需要额外注解；但REST的JSON请求必须用@RequestBody告诉Spring：把请求体里的JSON数据映射到DTO对象上。如果没加这个注解，Spring只会调用DTO的无参构造创建一个空实例，所有属性自然都是null。

修正后的RegistrationController示例： #

@RestController
@RequestMapping("/api")
public class RegistrationController {

    @Autowired
    private UserService userService;

    @PostMapping("/register")
    public ResponseEntity<String> registerUser(
            @RequestBody @Valid UserDto userDto,  // 这里必须加@RequestBody
            BindingResult result) {
        
        if (result.hasErrors()) {
            // 处理校验错误
            return ResponseEntity.badRequest().body("参数格式错误");
        }
        
        userService.save(userDto);
        return ResponseEntity.ok("注册成功");
    }
}

2. 确认UserDto的序列化/反序列化配置 #

Jackson（Spring默认的JSON处理器）需要满足几个条件才能正确映射属性：

• 必须有无参构造函数：如果你的UserDto只有带参构造，Jackson无法实例化对象，只能得到空实例。
• 属性要有getter/setter方法：Jackson默认通过getter/setter访问属性，如果你用Lombok，直接加@Data注解就能自动生成；如果手动写，确保每个属性都有对应的getter和setter。

正确的UserDto示例（用Lombok）： #

import jakarta.validation.constraints.Email;
import jakarta.validation.constraints.NotBlank;
import lombok.Data;

@Data  // 自动生成无参构造、getter、setter、equals/hashCode等
public class UserDto {
    @NotBlank(message = "用户名不能为空")
    private String username;

    @Email(message = "邮箱格式不正确")
    private String email;

    @NotBlank(message = "密码不能为空")
    private String password;
}

手动实现的UserDto示例： #

import jakarta.validation.constraints.Email;
import jakarta.validation.constraints.NotBlank;

public class UserDto {
    @NotBlank(message = "用户名不能为空")
    private String username;

    @Email(message = "邮箱格式不正确")
    private String email;

    @NotBlank(message = "密码不能为空")
    private String password;

    // 必须要有无参构造
    public UserDto() {}

    // 全参构造可选
    public UserDto(String username, String email, String password) {
        this.username = username;
        this.email = email;
        this.password = password;
    }

    // getter方法
    public String getUsername() { return username; }
    public String getEmail() { return email; }
    public String getPassword() { return password; }

    // setter方法
    public void setUsername(String username) { this.username = username; }
    public void setEmail(String email) { this.email = email; }
    public void setPassword(String password) { this.password = password; }
}

3. 验证REST请求的格式是否正确 #

• 请求头必须包含Content-Type: application/json：如果你的REST客户端没设置这个头，Spring会把请求当成表单数据处理，无法映射到JSON格式的DTO。
• JSON键名要和DTO属性名完全一致（大小写敏感）：比如DTO里是username，JSON里不能写成userName或者Username，否则Jackson无法匹配属性。

正确的请求示例（curl命令）： #

curl -X POST \
  http://localhost:8080/api/register \
  -H 'Content-Type: application/json' \
  -d '{
    "username": "ken4ward",
    "email": "ken4ward@example.com",
    "password": "yourpassword123"
}'

4. 检查依赖是否齐全 #

确保你的pom.xml（Maven）或build.gradle（Gradle）里包含了spring-boot-starter-web依赖——它默认已经引入了Jackson的JSON处理包，不需要额外添加。如果是自定义依赖，确认com.fasterxml.jackson.core:jackson-databind已经存在。

Maven依赖示例： #

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

按照上面的步骤排查，90%的概率能解决你的问题。如果还是不行，可以把你的具体代码片段贴出来，咱们再进一步分析。

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