Spring Boot配置PatchMapping后使用PUT请求报错的问题咨询

这个报错其实原因很直白：你用@PatchMapping注解定义的接口，只会接收HTTP PATCH方法的请求，当客户端发PUT请求过来时，Spring MVC找不到匹配的请求映射，就会抛出HttpRequestMethodNotSupportedException异常——这完全是预期行为，因为注解本身就是用来绑定特定HTTP方法的。

下面给你几个可行的解决方案，你可以根据自己的需求选择：

1. 直接改用PATCH请求调用接口 #

这是最贴合REST规范的做法。因为@PatchMapping通常用来实现部分资源更新（只修改资源的部分字段），而PUT一般对应全量更新（替换整个资源）。如果你的接口逻辑就是部分更新，建议让调用方改成发送PATCH请求，保持接口设计的语义一致性。

2. 修改接口注解，让它支持PUT请求 #

如果因为某些限制（比如客户端没法发PATCH请求）必须用PUT调用，那可以调整接口的请求映射配置：

方案2.1：替换为@PutMapping注解 #

直接把@PatchMapping改成@PutMapping，这样接口就只接收PUT请求了：

@PutMapping("/api/your-resource/{id}")
public ResponseEntity<YourResource> updateResource(@PathVariable Long id, @RequestBody YourResourceUpdateDto dto) {
    // 你的数据修改逻辑
    YourResource updatedResource = resourceService.updatePartial(id, dto);
    return ResponseEntity.ok(updatedResource);
}

方案2.2：让接口同时支持PUT和PATCH两种请求方法 #

用@RequestMapping注解显式指定支持的HTTP方法，这样两种请求都能匹配到这个接口：

@RequestMapping(
    value = "/api/your-resource/{id}",
    method = {RequestMethod.PUT, RequestMethod.PATCH}
)
public ResponseEntity<YourResource> updateResource(@PathVariable Long id, @RequestBody YourResourceUpdateDto dto) {
    // 你的数据修改逻辑
    YourResource updatedResource = resourceService.updatePartial(id, dto);
    return ResponseEntity.ok(updatedResource);
}

3. 特殊场景：通过请求转换支持PUT（不推荐） #

如果客户端完全无法发送PATCH请求（比如某些老旧的HTTP客户端不支持），可以考虑通过过滤器或拦截器，将特定条件的PUT请求转换成PATCH请求。比如检查请求头里的自定义标识（如X-HTTP-Method-Override: PATCH），然后修改请求方法。不过这种方式属于临时 workaround，会模糊REST语义，除非万不得已不建议使用。

内容的提问来源于stack exchange，提问作者Sean Meng Kong