为什么很多 SpringBoot 开发者放弃了 Tomcat,选择了 Undertow?
关于“Spring Boot开发者放弃Tomcat转投Undertow”的说法在技术社区流传已久,但这一表述与框架实际情况存在偏差。通过对Spring Boot 2.7、3.5及4.0版本源码的深度解析,可以发现Tomcat一直是默认的嵌入式容器,而Undertow在最新的4.0版本中甚至已被彻底移除。本文将从源码层面梳理容器选择机制、版本演进路径及迁移策略。
01容器选择的源码机制
在Spring Boot的默认Web场景中,容器选择并非通过复杂的优先级配置决定,而是基于依赖传递与条件注解的组合。核心逻辑位于自动配置类中,通过检查类路径下是否存在特定容器类来激活对应的工厂Bean。
默认容器 vs 备选容器
Tomcat
官方定位:作为 spring-boot-starter-web 的默认内置依赖,无需额外配置即开箱即用。
激活机制:由于默认依赖存在,Tomcat相关的类必定位于类路径,@ConditionalOnClass 条件最先满足。
Bean注册:一旦 TomcatServletWebServerFactory 注册成功,@ConditionalOnMissingBean 会阻止后续其他容器的工厂类注册。


Jetty / Undertow
官方定位:被官方明确定义为 an alternative to spring-boot-starter-tomcat(Tomcat的替代方案)。
激活前提:必须在 pom.xml 或 build.gradle 中显式排除默认的 Tomcat 依赖,并引入对应的 Jetty 或 Undertow Starter。
生效顺序:只有在 Tomcat 类缺失的情况下,自动配置才会按顺序向后尝试匹配 Jetty 或 Undertow。
02版本演进与重大变更
- 2025年
- 2023年
- 2022年
Spring Boot 4.0版本带来了架构层面的重大调整。最显著的变化是Undertow支持被完全移除,源码中已找不到相关的Starter和自动配置类。此外,原有的集中式配置类 ServletWebServerFactoryConfiguration 被拆分,各容器模块实现了独立的自动配置管理。原有的 spring-boot-starter-web 也被标记为废弃,由 spring-boot-starter-webmvc 取代,但其默认依赖依然是 Tomcat。
03容器切换与迁移指南
切换容器本质上是对类路径依赖的调整。无论是2.7、3.x还是4.0版本,核心逻辑保持一致:排除Tomcat,引入目标容器。需要注意的是,由于4.0已移除Undertow,相关项目必须迁移至Tomcat或Jetty。
| 操作步骤 | Maven 配置示例 | Gradle 配置示例 |
|---|---|---|
| 步骤1:排除默认Tomcat | configurations { compileOnly.extendsFrom annotationProcessor } dependencies { implementation('org.springframework.boot:spring-boot-starter-web') { exclude group: 'org.springframework.boot', module: 'spring-boot-starter-tomcat' } } | |
| 步骤2:引入目标容器 | implementation 'org.springframework.boot:spring-boot-starter-jetty' | |
| 4.0版本注意点 | Starter名称更换为 spring-boot-starter-webmvc,排除与引入逻辑一致。 | 不再支持 Undertow,仅可选择 Tomcat 或 Jetty。 |
不同构建工具下的容器切换操作对比
综上所述,Tomcat在Spring Boot生态中的主导地位并未改变,所谓的“放弃”更多是基于特定性能场景下的个性化选择,而非框架层面的默认行为迁移。随着4.0版本的发布,Undertow的退出进一步确立了Tomcat与Jetty双雄并立的格局。开发者在进行技术选型时,应基于项目实际需求与长期维护成本进行决策,而非盲目跟风网络传言。
当前文章无评论,是时候发表评论了