在 spring boot 中定义 put 请求,需要在 controller 方法上使用 @putmapping 注解,并配合
@PutMapping
如何映射 URL 路径?
通过 @PutMapping("/users/{id}") 可以指定具体的资源路径,其中 {id} 是占位符,用于匹配 URL 中的动态参数。使用 @PathVariable 可以将 URL 中的值注入到方法参数中,从而定位需要更新的具体资源。

import org.springframework.web.bind.annotation.*;
@RestController
@RequestMapping("/api/users")
public class UserController {
@PutMapping("/{id}")
public User updateUser(@PathVariable Long id, @RequestBody User user) {
user.setId(id);
// 执行更新逻辑
return userService.update(user);
}
}
上述代码展示了完整的控制器实现。当客户端发送 PUT 请求到 /api/users/101 时,id 参数会被赋值为 101,而请求体中的 JSON 数据会被绑定到 user 对象。如果请求头中缺少 Content-Type: application/json,Spring Boot 将无法正确解析请求体,导致 415 错误。
PUT 与 POST 在语义和幂等性上有何区别?
PUT 请求的核心特征是幂等性,即多次执行相同的 PUT 请求对服务器产生的影响是一致的。相比之下,POST 通常用于创建新资源,每次调用都会产生新的唯一标识。在处理更新操作时,PUT 要求客户端提供资源的完整状态或部分字段,服务端根据这些字段进行覆盖或合并。

// 模拟幂等性验证
User existing = userService.findById(101);
existing.setName("New Name");
userService.save(existing);
// 再次执行相同请求
User result = userService.findById(101);
assert result.getName().equals("New Name");
在实际开发中,如果前端只希望更新部分字段,可以使用 PATCH 请求,或者在 PUT 中允许 null 值表示不修改。但标准的 RESTful 实践建议 PUT 用于全量更新。若使用 POST 模拟更新,则无法保证幂等性,可能导致重复提交问题。
当 @RequestBody 接收到空 JSON 时会发生什么?
如果客户端发送 PUT 请求但请求体为空或仅包含 {},Spring Boot 会尝试将空对象绑定到目标类。对于基本类型字段,它们将保持默认值(如 0 或 false);对于引用类型字段,它们将为 null。这可能导致后续业务逻辑中出现 NullPointerException,除非在 Service 层做了防御性检查。











