Spring5.1升5.2:requestMappingHandlerMapping报错与方法废弃问题
Spring 5.1升级至5.2版本WebMvc配置兼容问题解决
报错核心原因
- 编译参数不匹配报错:Spring 5.2调整了
WebMvcConfigurationSupport类中requestMappingHandlerMapping()的方法签名,从5.1版本的无参定义,修改为需要传入ContentNegotiationManager、FormattingConversionService、ResourceUrlProvider三个依赖参数的有参形式。原项目中无参的重写方法已经无法匹配父类方法定义,即使删除方法内部的废弃调用代码,只要保留无参的重写结构,就会触发编译不兼容错误。 - 方法废弃报错:
setUseSuffixPatternMatch()、setUseTrailingSlashMatch()被标记废弃,并非对应功能移除,而是Spring官方将路径匹配相关的配置入口统一收拢至PathMatchConfigurer组件,避免直接操作底层处理器映射实例带来的版本兼容风险。
替代实现方案
完全不需要重写requestMappingHandlerMapping()方法,通过重写WebMvc的标准路径匹配配置扩展点即可实现原有配置逻辑:
- 删除原来重写无参
requestMappingHandlerMapping()的全部代码,从根源上解决父类方法签名不匹配的编译错误 - 重写
configurePathMatch(PathMatchConfigurer configurer)方法,将原有路径匹配规则通过配置类API设置,替代原来直接操作RequestMappingHandlerMapping实例的写法
兼容后的配置类示例
@Configuration public class WebMvcConfiguration extends WebMvcConfigurationSupport { @Override protected void configurePathMatch(PathMatchConfigurer configurer) { // 关闭后缀模式匹配,替代原handlerMapping.setUseSuffixPatternMatch(false) configurer.setUseSuffixPatternMatch(false); // 关闭尾斜杠匹配,替代原handlerMapping.setUseTrailingSlashMatch(false) configurer.setUseTrailingSlashMatch(false); } }
注意事项
- 不要手动重写5.2版本带三个参数的
requestMappingHandlerMapping()底层方法,这类方法的三个参数是Spring容器在初始化Bean时自动按依赖注入的,手动重写会打乱Spring自身的Bean初始化流程,引入额外的运行时兼容问题 - 所有路径匹配相关的自定义配置,优先使用官方暴露的
PathMatchConfigurer扩展API,不要直接干预底层RequestMappingHandlerMapping的实例创建流程,可大幅降低大版本升级时的兼容成本
内容的提问来源于stack exchange,提问作者mahathi bandari
相关产品推荐
相关产品推荐

