Spring Boot1.5.x升2.3.x后@RequestParam修饰Map参数报错如何解决
问题根因
- Spring Boot 2.x配套的Spring 5.x对参数校验逻辑有调整,更大概率是项目中使用的旧版本SpringFox(Swagger)依赖的参数校验逻辑不兼容,会对标注
@RequestParam的非基本/非包装类型直接抛出该编译/启动错误。 - 你当前的写法本身是Spring MVC原生支持的合法写法:用
@RequestParam不加参数名标注Map<String,String>时,会自动接收所有请求参数的键值对。
解决方案
方案1:关闭SpringFox非法参数校验(最快捷,无需修改接口代码)
在项目的SpringFox配置类中新增如下Bean,跳过对@RequestParam标注的Map类型参数的错误校验:
@Bean public WebMvcRequestHandlerProvider webMvcRequestHandlerProvider( RequestMappingInfoHandlerMapping requestMappingHandlerMapping, List<HandlerMethodParameterProcessor> handlerMethodParameterProcessors, List<HandlerMethodReturnTypeProcessor> handlerMethodReturnTypeProcessors) { return new WebMvcRequestHandlerProvider(Optional.empty(), requestMappingHandlerMapping, handlerMethodParameterProcessors, handlerMethodReturnTypeProcessors) { @Override protected boolean isRequestBody(MethodParameter parameter) { // 跳过Map类型@RequestParam的非法校验 if (parameter.hasParameterAnnotation(RequestParam.class) && Map.class.isAssignableFrom(parameter.getParameterType())) { return false; } return super.isRequestBody(parameter); } }; }
方案2:升级接口文档依赖版本
将项目中的SpringFox依赖升级到3.0.0及以上版本,该版本已经修复了和Spring Boot 2.x的参数校验兼容问题,不需要修改原有接口代码。
方案3:调整参数获取逻辑(无侵入无需修改依赖/配置)
如果不想调整依赖和配置,也可以删除@RequestParam Map<String, String> reqParam参数声明,直接从HttpServletRequest中获取所有请求参数:
// 接口方法内新增参数转换逻辑 Map<String, String> reqParam = req.getParameterMap().entrySet().stream() .collect(Collectors.toMap(Map.Entry::getKey, entry -> entry.getValue()[0]));
额外注意
你代码中的HttpServeletRequest存在拼写错误,正确类名为HttpServletRequest,该问题也可能引发编译错误,建议优先修正拼写后再排查兼容问题。
内容的提问来源于stack exchange,提问作者Dams
相关产品推荐
相关产品推荐

