Postman调用SpringBoot PUT接口无报错但数据未更新问题

核心根因 #

绝大多数该场景问题都是传参方式和后端接收规则不匹配导致的：

• 你的Controller层更新接口使用@RequestParam注解接收name和email参数，这类参数需要以URL查询参数的形式传递，也就是拼在请求地址后方，格式为?参数名=参数值。如果你在Postman测试时把两个参数填到了请求Body区域（无论是form-data、x-www-form-urlencoded还是raw/json格式），后端都无法读取到这两个参数，实际接收到的name和email均为null。
• 对应Service层的更新逻辑做了前置判断：只有当参数非null、长度大于0，且和数据库原有值不一致时，才会执行字段set操作。参数全为null时所有判断分支都不会触发，方法正常执行完成返回200响应，没有任何报错抛出，但数据库不会产生任何改动。

快速验证方法 #

在StudentService的updateStudent方法第一行打调试断点，发起Postman请求后观察IDEA调试面板中name、email两个变量的值，如果显示为null即可确认是上述问题。

修复方案 #

二选一即可，根据你的接口设计习惯选择：

方案1：不修改后端代码，调整Postman传参规则 #

发PUT请求时不要在Body区域填参数，两种方式传参都可以：

• 直接在请求URL后拼接参数，示例：http://localhost:8080/students/1?name=张三&email=zhangsan@example.com
• 在Postman的Params标签页下，找到QUERY PARAMETERS区域，新增两行参数：key填name、value填要更新的姓名，key填email、value填要更新的邮箱，Postman会自动把参数拼接到URL上，发送请求即可正常更新。

方案2：修改后端接收逻辑，支持请求体传参（更符合RESTful更新接口规范） #

如果习惯将更新参数放在请求体中传递，调整后端代码即可：

1. 新建更新操作专用的DTO类承载参数：

public class StudentUpdateParam {
    private String name;
    private String email;

    // 生成对应属性的getter、setter方法
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
    public String getEmail() { return email; }
    public void setEmail(String email) { this.email = email; }
}

2. 修改Controller层更新方法的参数接收注解：

@PutMapping(path ="{studentId}")
public void updateStudent(
        @PathVariable("studentId") Long studentId,
        @RequestBody StudentUpdateParam updateParam)
{
    studentService.updateStudent(studentId, updateParam.getName(), updateParam.getEmail());
}

调整完成后，Postman发请求时选择Body->raw->JSON格式，传入如下结构的参数即可正常更新：

{
    "name": "张三",
    "email": "zhangsan@example.com"
}

小概率问题排查 #

如果上述方案调整后仍然不更新，检查两点即可：

• 确认你传入的name、email值和数据库中id=1记录的原有值完全一致，此时Objects.equals判断结果为true，不会触发更新逻辑，属于正常表现。
• 确认Student实体类的name、email属性都添加了正确的setter方法，你提到已经编写对应setter/getter，该点基本可以排除。

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