SpringBoot 内嵌 Tomcat 的启动流程

Spring Boot 内嵌 Tomcat 的启动流程 ,本质上就是把"手动部署WAR包到外部Tomcat"这件事,变成通过Java代码在main方法里一键启动。

整个流程拆成三大阶段,用最通俗的话讲透:


阶段一:SpringApplication 启动,触发自动配置

当你点击运行@SpringBootApplication的main方法时:

  1. SpringApplication.run()开始执行核心刷新(refresh)容器。

  2. Spring Boot的自动配置机制 会扫描类路径,发现你依赖了spring-boot-starter-web,这会触发ServletWebServerFactoryAutoConfiguration配置类。

  3. 这个配置类会做一件事:创建一个内嵌Web服务器的工厂。

    • 默认情况下,因为Tomcat的依赖存在,它会创建TomcatServletWebServerFactory。

    • 这个工厂就是专门负责"生产"Tomcat服务器的。


阶段二:创建并配置 Tomcat 实例

这个阶段是整个流程的肉 ,它发生在refresh上下文时的onRefresh()方法里,具体步骤如下:

  1. 工厂开始构建 :TomcatServletWebServerFactory的getWebServer()方法被调用,此时会:

    • 实例化一个原生的org.apache.catalina.startup.Tomcat对象。

    • 设置基础目录(basedir),通常是操作系统的临时目录。

  2. 配置核心组件(Engine/Host/Context):

    • 创建Engine (引擎),默认名字叫"Tomcat"。

    • 创建Host (虚拟主机),默认是localhost,并设置应用根目录。

    • 最关键的一步 :创建Context (上下文)。这个Context代表你的整个Spring Boot应用,它的路径通常是空字符串""(即根路径)。

  3. 添加Servlet(即DispatcherServlet):

    • Spring Boot会创建一个DispatcherServlet的Bean。

    • 然后将这个Servlet动态添加 到刚才创建的Context中,并映射到"/"(即所有请求)。

    • 注意 :这里的添加并不是通过web.xml,而是通过编程方式调用Tomcat.addServlet()和Context.addServletMapping()。

  4. 设置端口和连接器:

    • 读取你配置文件里的server.port(默认8080),设置到Tomcat的Connector(连接器)上。

    • 默认使用NIO协议 (org.apache.coyote.http11.Http11NioProtocol)。

此时,Tomcat实例已经构建完毕,但还没有启动,只是准备好了。


阶段三:启动 Tomcat 并发布 ServletContext

这是最后的点火动作:

  1. 触发启动 :在refresh容器的最后一步(finishRefresh),会调用TomcatWebServer的start()方法。

  2. 内部启动链:

    • 调用Tomcat.start() -> 这会启动所有组件(Connector、Engine、Host、Context)。

    • 连接器(Connector)开始监听指定端口,准备接收HTTP请求。

    • 同时,会触发ServletContextInitializer回调,执行你所有的Filter、Listener的初始化。

  3. 发布事件 :启动成功后,Spring Boot会发布ServletWebServerInitializedEvent事件,表示内嵌服务器已就绪。

  4. 阻塞等待 :最后,TomcatWebServer会启动一个非守护线程(keepAlive),让主线程阻塞,保证Tomcat一直运行,等待请求进来。


核心时序图

与外部Tomcat部署的关键区别(面试加分点)

对比维度 外部Tomcat(传统WAR) Spring Boot 内嵌Tomcat
启动入口 由Tomcat脚本(catalina.sh)触发 由Java的main()方法触发
Servlet容器 独立进程,部署多个WAR 嵌入在JVM中,随应用启动和停止
Context创建方式 解析web.xml或注解扫描 编程式创建Context,并手动注册DispatcherServlet
类加载器 复杂的委派机制(Common/Shared/Webapp) 相对简单,直接使用应用类加载器(AppClassLoader)
适用场景 多应用共享Tomcat 微服务、云原生、独立运行
相关推荐
颜进强4 小时前
16 · NestJS LifecycleEvents 生命周期事件:五个钩子、三条边界,和 rag-server 的优雅停机
前端·后端·ai编程
GetcharZp4 小时前
定位不再一个个吐坐标:英伟达 LocateAnything 上手全攻略
后端
需要8264 小时前
分布式事务:Seata AT/TCC/SAGA 的取舍与踩坑
java·spring boot·分布式·spring·spring cloud
晨小安4 小时前
ThreadLocal及其内存泄漏问题深度解析
java·jvm·tomcat·哈希表
m0_587383005 小时前
深圳24小时自助健身房解决方案实战:从系统架构到部署指南
java·人工智能·spring boot·spring·系统架构·需求分析
郑州光合科技余经理5 小时前
同城电商系统:库存变更怎么同步到订单
java·开发语言·前端·后端·uni-app·php·ai编程
我叫黑大帅5 小时前
Go日志库工程选型与逃逸分析评测报告
后端·面试·go
小马哥程序开发7 小时前
[点赞收藏免费领取 · 项目源码]57105基于Spring Boot的充电桩管理系统的设计与实现
java·spring boot·源码·课程设计·毕设·大作业·课设
IT_陈寒8 小时前
JavaScript闭包的这个坑,我居然今天才爬出来
前端·人工智能·后端