重写Spring FormHttpMessageConverter不生效,如何将URL解码异常改为返回400
1. 自定义CustomizedFormHttpMsgConverter未生效的原因
Spring MVC的消息转换器匹配规则是按列表顺序匹配,只要找到第一个支持当前请求Content-Type的转换器就会直接调用,不再遍历后续转换器。
你自定义的转换器注册时如果是通过configureMessageConverters方法的add()方法追加,会被放到原生FormHttpMessageConverter的后面,所以处理application/x-www-form-urlencoded类型请求时会优先调用原生转换器,你的自定义实现自然不会触发。
如果要让自定义转换器优先生效,需要把它插入到转换器列表的最前面,注册代码参考:
@Configuration public class WebConfig implements WebMvcConfigurer { @Override public void configureMessageConverters(List<HttpMessageConverter<?>> converters) { // 把自定义转换器插到列表最开头,优先匹配 converters.add(0, new CustomizedFormHttpMsgConverter()); } }
如果你的项目中显式使用了@EnableWebMvc注解,会覆盖Spring Boot的默认MVC配置,需要确认注册逻辑是在该注解扫描到的配置类中。另外需要确认你的自定义转换器没有修改supportedMediaTypes属性,仍然支持application/x-www-form-urlencoded类型,否则也会匹配失败。
2. 继承FormHttpMessageConverter实现需求的方案合理性
这个方案本身是合理的,属于从根源拦截解码异常的实现方式,逻辑清晰,符合Spring扩展消息转换器的设计规范。
除了这个方案之外,你也可以选择更轻量的实现:直接配置全局异常处理器,捕获URLDecoder抛出的IllegalArgumentException,判断请求类型为表单提交时直接返回400状态码,不需要修改转换器逻辑,代码示例:
@RestControllerAdvice public class GlobalExceptionHandler { @ExceptionHandler(IllegalArgumentException.class) public ResponseEntity<Map<String, String>> handleDecodeException(IllegalArgumentException e) { if (e.getMessage() != null && e.getMessage().contains("URLDecoder")) { return ResponseEntity.badRequest().body(Collections.singletonMap("msg", "请求参数格式非法")); } // 其他异常走原有逻辑 throw e; } }
两种方案都可以达到目标,你可以根据项目的实际改造复杂度选择。
内容的提问来源于stack exchange,提问作者Ken Wang
相关产品推荐
相关产品推荐

