当前位置: 首页 > news >正文

WebMvcConfigurationSupport vs WebMvcConfigurer 的本质区别

springboot项目中MVCconfiguration配置是继承WebMvcConfigurationSupport还是实现WebMvcConfigurer 呢?这两者有什么区别呢?

WebMvcConfigurationSupport

  WebMvcConfigurationSupport 是 Spring MVC 的底层配置类,继承了它,Spring Boot 会检测到你提供了自己的 MVC 配置

  • Spring Boot 的 WebMvcAutoConfiguration(自动配置)会完全失效
  • 所有默认配置都没了,包括:
    • ✗ 静态资源映射
    • ✗ 消息转换器
    • ✗ 格式化器
    • ✗ SpringDoc 的自动配置
    • ✗ 其他很多默认功能
  • 继承 WebMvcConfigurationSupport 时,必须手动配置所有资源映射

WebMvcConfigurer 

  WebMvcConfigurer 是 Spring MVC 的扩展接口

  • 实现它只是添加/增强配置,不会覆盖
  • Spring Boot 的自动配置继续生效
  • 自定义配置会叠加在默认配置之上
  • 实现 WebMvcConfigurer 时,Spring Boot 已经自动配置好了:
    •   /static/ 目录自动映射
    •   /webjars/** 自动映射(包括 SpringDoc 的资源)

 

1 public class WebMvcConfiguration extends WebMvcConfigurationSupport {
2     // 完全覆盖 Spring Boot 的 Web 自动配置
3 }
4 
5 public class WebMvcConfiguration implements WebMvcConfigurer {
6     // 只是增强,不会破坏 Spring Boot 的自动配置
7 }

两者作用总结:

类/接口作用典型用法
WebMvcConfigurer Spring Boot 提供的扩展点接口,允许你“定制”Spring MVC 的默认行为 实现接口(或使用 @Configuration + implements WebMvcConfigurer)添加拦截器、格式化器、CORS 等
WebMvcConfigurationSupport Spring MVC 的底层配置类基类,相当于自己“接管整个 MVC 配置” 继承它来自定义 MVC 配置(但会屏蔽 Spring Boot 自动配置)

核心区别:

对比点WebMvcConfigurerWebMvcConfigurationSupport
类型 接口 抽象类
默认配置 不影响 Spring Boot 的自动配置 一旦继承它,会禁用 Spring Boot 自动配置(例如静态资源、默认视图解析器等)
使用方式 推荐在 @Configuration 类中实现 仅在需要完全自定义 MVC 时使用
多配置共存 可以定义多个 WebMvcConfigurer Bean(Spring 会合并) 只能有一个 WebMvcConfigurationSupport 子类
常见场景 添加拦截器、消息转换器、CORS、自定义参数解析器等 编写框架/SDK 或需要完全控制 MVC 配置(很少见)

推荐用法:

 1 @Configuration
 2 public class MyWebMvcConfig implements WebMvcConfigurer {
 3 
 4     @Override
 5     public void addInterceptors(InterceptorRegistry registry) {
 6         registry.addInterceptor(new MyInterceptor()).addPathPatterns("/**");
 7     }
 8 
 9     @Override
10     public void addCorsMappings(CorsRegistry registry) {
11         registry.addMapping("/**").allowedOrigins("*");
12     }
13 }

高级用法:

1 @Configuration
2 public class MyMvcConfiguration extends WebMvcConfigurationSupport {
3 
4     @Override
5     protected void addInterceptors(InterceptorRegistry registry) {
6         registry.addInterceptor(new MyInterceptor()).addPathPatterns("/**");
7     }
8 }

但这样一来:

  • Spring Boot 默认的静态资源访问(如 /static/**, /public/**)会失效;

  • 默认的 RequestMappingHandlerAdapterMessageConverters 等配置也会被覆盖;

  • 需要手动补回全部配置

因此如果只是加个拦截器或格式化器,不建议用这个。

内部原理简述:

  • WebMvcAutoConfiguration(Spring Boot 提供)默认会加载一套 MVC 配置;

  • 该配置会自动检测是否存在一个继承 WebMvcConfigurationSupport 的类:

    • 如果有,则跳过 Boot 自动配置

    • 如果没有,则启用默认配置;

  • WebMvcConfigurer 的实现类只是往默认配置中“追加配置”,不会替换掉原有的。

对比总结:

image

 常见使用坑:

  • ❌ 误继承 WebMvcConfigurationSupport → 导致静态资源、Swagger 页面、favicon 等访问 404

  • ❌ 同时存在多个 WebMvcConfigurationSupport 子类 → 启动报错或配置混乱

  • ✅ 想“局部增强”时实现 WebMvcConfigurer 是最稳妥的方案

启动日志对比

extends WebMvcConfigurationSupport:
2025-11-05 09:54:19.928  INFO ... Tomcat started on port 8090
2025-11-05 09:54:19.945  INFO ... Started SmartAlbumApplication in 5.948 seconds

❌ 没有 SpringDoc 初始化日志 → SpringDoc 没有启动

implements WebMvcConfigurer:
重启后能看到类似这样的日志:
INFO ... Initializing Spring DispatcherServlet 'dispatcherServlet'
INFO ... Initialized SpringDoc OpenAPI
INFO ... Started SmartAlbumApplication in X.XXX seconds
 ✅ SpringDoc 正常初始化 → Swagger UI 可以访问

总结

在 Spring Boot 项目中:

  • 🎯 90% 的情况用 implements WebMvcConfigurer(推荐)
  • ⚠️ 只有需要完全自定义 MVC 配置时才用 extends WebMvcConfigurationSupport
  • 💡 记住:继承会覆盖,实现会增强

 

目的建议使用
想在 Boot 默认 MVC 上扩展 WebMvcConfigurer
想完全控制 MVC 行为(例如做自定义框架、二次封装) ⚠️ WebMvcConfigurationSupport
想自定义静态资源路径但仍保留默认功能 ✅ 使用 WebMvcConfigurer 而非继承 Support

 

 

 

 

 

 

 
 
 
 
 
 
 
 
 
http://www.jsqmd.com/news/33296/

相关文章:

  • 成功拿到备案号 | 详述大模型备案
  • MATLAB与ModBus RTU设备进行串行通信
  • 2025年艾草贴厂家权威推荐榜单:老北京足贴/蒸汽眼罩/泡澡液源头生产厂家精选
  • 封装新纪元
  • 高精度板子
  • 成都恒利泰宽带锥形电感,一颗顶三颗
  • 微算法科技(NASDAQ MLGO)采用动态层次管理和位置聚类技术,修改pBFT算法以提高私有区块链网络运行效率
  • 2025年上海展览特装制作公司权威推荐榜单:标摊设计/标摊装修/展厅设计及施工源头公司家精选
  • 2025年PE-RT管材管件批发厂家权威推荐榜单:ppr电熔管件/PERT电熔管件/PERT2型管件源头厂家精选
  • 2025年透明吹塑HDPE防撞桶改性再生颗粒生产厂家权威推荐:环保连卷袋吹膜级透明HDPE颗粒/挤塑透明HDPE再生颗粒/透明吹塑HDPE水箱改性再生颗粒源头生产商精选
  • 护航“苏超”票务稳健运行!这朵云,靠谱!
  • doris命令show proc /current_queries;
  • 2025 国内靠谱的代理 IP 哪家好选择指南​
  • 2025年石膏基自流平生产商权威推荐:水泥自流平砂浆/石膏自流平砂浆/地面找平自流平源头厂家精选
  • 深入解析:webSocket快速入门
  • 2025年青岛城阳注册个体户服务权威推荐:青岛城阳公司变更服务/青岛城阳变更营业执照机构/青岛城阳公司减资服务机构精选
  • 11.6 考试总结
  • Redis的Hash解析 - 实践
  • 软件工程实践团队项目第一次作业
  • 水仙数练习循坏
  • 2025年紫檀手串性价比排名榜,紫檀手串哪家好
  • 使用 NIFI监控数据库表
  • 利用Libevent在CentOS 7上打造异步网络应用
  • 20251105周三日记
  • 完整教程:基于 PyQt5 实现刀具类型选择界面的设计与交互逻辑
  • JS 日期格式化显示
  • 2025年广东菲律宾家具集运服务权威推荐:广东家具拼柜菲律宾公司/广东家具集装箱菲律宾平台/广东食品海运菲律宾渠道精选
  • 告别文件混乱!Adobe Bridge 2026 全媒体可视化管理,让设计流程更顺畅
  • build插件
  • 2025年山东地区信誉好的UG编程培训企业推荐:UG编程培训品牌公司全解析