Spring Boot：PATCH请求无法映射模型但相同POST请求可正常映射

这种情况我之前在项目里也碰到过，Spring Boot 2.x版本里PATCH请求的参数绑定确实有几个容易踩的小坑，咱们一步步来排查解决：

1. 确认请求头的Content-Type配置 #

首先要确保你的PATCH请求头里Content-Type明确设置为application/json——虽然POST请求可能自动带上了，但有些工具（比如axios）在发送PATCH请求时可能不会默认设置这个头，导致Spring无法识别请求体格式，自然就没法映射参数了。

2. 显式指定接口的consumes属性 #

给你的PATCH接口方法加上consumes = MediaType.APPLICATION_JSON_VALUE，明确告诉Spring这个接口只接收JSON格式的请求体，比如：

@PatchMapping(value = "/your-api-path", consumes = MediaType.APPLICATION_JSON_VALUE)
public ResponseEntity<?> updateBuilding(@Validated @RequestBody BuildingDTO buildingDTO) {
    // 你的业务逻辑
}

这一步能强制Spring使用JSON消息转换器来解析PATCH的请求体，避免默认配置的遗漏。

3. 排查消息转换器的支持范围 #

Spring Boot 2.0.0版本中，默认的MappingJackson2HttpMessageConverter可能没有对PATCH方法开启支持。你可以自定义一个Web配置类，让转换器明确支持PATCH方法：

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {
    @Override
    public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
        MappingJackson2HttpMessageConverter jacksonConverter = new MappingJackson2HttpMessageConverter();
        // 支持JSON格式
        jacksonConverter.setSupportedMediaTypes(Arrays.asList(
            MediaType.APPLICATION_JSON,
            MediaType.APPLICATION_JSON_UTF8
        ));
        // 明确指定支持的HTTP方法，包含PATCH
        jacksonConverter.setSupportedMethods(HttpMethod.POST, HttpMethod.PUT, HttpMethod.PATCH, HttpMethod.GET);
        converters.add(jacksonConverter);
    }
}

4. 用HttpEntity手动接收请求体排查问题 #

如果上面的方法都没效果，可以先绕过Spring的自动参数绑定，用HttpEntity<String>直接接收请求体，手动反序列化看看能不能拿到数据：

@PatchMapping("/your-api-path")
public ResponseEntity<?> updateBuilding(HttpEntity<String> requestEntity) {
    String requestBody = requestEntity.getBody();
    ObjectMapper objectMapper = new ObjectMapper();
    try {
        BuildingDTO buildingDTO = objectMapper.readValue(requestBody, BuildingDTO.class);
        // 这里可以打印buildingDTO看看是否有值
        return ResponseEntity.ok(buildingDTO);
    } catch (JsonProcessingException e) {
        return ResponseEntity.badRequest().body("请求体解析失败");
    }
}

如果手动反序列化能拿到正确的数据，说明是Spring的自动参数绑定逻辑对PATCH请求的支持有问题，这时候就需要重点排查消息转换器或者Spring的版本bug了。

5. 检查拦截器/过滤器的干扰 #

如果你的项目里有自定义的拦截器或过滤器，要确认它们没有修改或丢弃PATCH请求的请求体。比如有些拦截器会读取一次请求体后没有重置，导致后续的参数绑定拿不到数据。可以暂时禁用这些自定义组件，测试PATCH请求是否正常。

最后提一句：Spring Boot 2.0.0是比较老旧的版本了，存在不少已知的bug，建议如果业务允许的话，升级到2.0.x系列的最新稳定版，或者直接升级到2.7.x这类长期支持版本，能避免很多这类奇怪的问题。

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