POST方法新增RequestBody对象参数后请求返回400 Bad Request问题求助

问题根因 #

该错误由Spring MVC默认的JSON序列化工具Jackson反序列化失败导致，请求在进入控制器前的HTTP消息转换阶段就抛出异常，因此直接返回400 Bad Request。
具体原因：

• 你的NewParam为不可变类，字段均为final修饰，仅提供了自定义带参构造函数，没有无参构造和setter方法
• 不传myNewparam或传null时，Jackson无需构造NewParam实例，可以正常初始化MyRequestDto，因此返回201
• 当传入非空myNewparam对象时，Jackson无法识别NewParam带参构造的参数和JSON字段的映射关系，反序列化失败抛出异常

解决方案 #

方案1：使用JDK原生@ConstructorProperties注解（推荐，不破坏不可变性，无额外依赖） #

给NewParam类的构造函数添加注解，明确构造参数和JSON字段的对应关系即可：

public class NewParam {
    private final String name;

    @ConstructorProperties("name")
    public NewParam(String name) {
        this.name = name;
    }

    public String getName() {
        return name;
    }
}

如果你使用JDK 16及以上版本，也可以直接将NewParam定义为record类，Jackson天然支持record类的反序列化：

public record NewParam(String name) {}

方案2：使用Jackson专属注解 #

通过@JsonCreator标记反序列化使用的构造函数，@JsonProperty绑定参数对应的JSON字段：

public class NewParam {
    private final String name;

    @JsonCreator
    public NewParam(@JsonProperty("name") String name) {
        this.name = name;
    }

    public String getName() {
        return name;
    }
}

方案3：添加无参构造和setter方法（不推荐，破坏类的不可变性） #

如果业务允许NewParam为可变类，可以添加无参构造函数和对应字段的setter方法，Jackson默认即可完成反序列化：

public class NewParam {
    private String name;
    // 新增无参构造
    public NewParam() {}

    public NewParam(String name) {
        this.name = name;
    }
    // 新增setter
    public void setName(String name) {
        this.name = name;
    }

    public String getName() {
        return name;
    }
}

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