SpringBoot 内置服务器（Tomcat/Jetty/Undertow）切换

用 SpringBoot 开发时你可能从没关注过“服务器”这件事——点一下启动接口就能访问默认用的是 Tomcat。但实际开发中不同场景需要不同的服务器比如追求高性能选 Undertow追求轻量选 Jetty兼容老项目选 Tomcat。今天就手把手教你SpringBoot 里怎么切换内置服务器Tomcat→Jetty→Undertow以及三种服务器的核心区别、选型建议——纯实操改几行配置就能搞定再也不用被“默认 Tomcat”绑死。先搞懂SpringBoot 为啥能“内置”服务器SpringBoot 之所以能一键启动核心是把 Tomcat/Jetty/Undertow 这些 Web 服务器打包成了依赖启动时自动初始化不用我们手动安装、配置。核心逻辑spring-boot-starter-web依赖默认引入spring-boot-starter-tomcat内置 Tomcat切换服务器的本质排除默认的 Tomcat 依赖引入目标服务器的 Starter 依赖所有服务器都适配 SpringBoot 的WebServer接口切换后代码无需任何改动。先看三款内置服务器的核心差异新手先记结论特性Tomcat默认JettyUndertow核心优势生态完善、兼容性好、文档多轻量、启动快、适合长连接WebSocket高性能、低内存、并发能力强核心劣势内存占用较高、并发性能一般并发性能弱于 Undertow功能比 Tomcat 少、文档相对少适用场景通用场景、传统 Web 项目、新手轻量应用、WebSocket 应用如聊天高并发接口、微服务、性能敏感场景内存占用同等配置高中低并发处理能力中中低高默认服务器——TomcatSpringBoot 项目只要引入spring-boot-starter-web就自动用 Tomcat 作为内置服务器1 2dependency 3groupIdorg.springframework.bootgroupId 4artifactIdspring-boot-starter-webartifactId 5dependency启动项目日志里会看到 Tomcat 启动的痕迹2026-03-19 10:00:00.000 INFO 12345 --- [ main] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat initialized with port 8080 (http) 2026-03-19 10:00:00.123 INFO 12345 --- [ main] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat started on port 8080 (http)如果想自定义 Tomcat 配置比如调线程数、最大连接数在application.yml里加1server: 2 tomcat: 3max-threads:200# 最大工作线程数默认200 4min-spare-threads:20# 最小空闲线程数 5max-connections:10000# 最大连接数 6accept-count:100# 连接队列长度满了之后新请求会被拒绝切换到 JettyJetty 比 Tomcat 更轻量启动更快对 WebSocket 支持更友好比如做即时聊天、消息推送项目。第一步排除 Tomcat 依赖引入 Jetty 依赖修改pom.xml核心是“先排除、再引入”1dependencies 2 3dependency 4groupIdorg.springframework.bootgroupId 5artifactIdspring-boot-starter-webartifactId 6 7exclusions 8exclusion 9groupIdorg.springframework.bootgroupId 10artifactIdspring-boot-starter-tomcatartifactId 11exclusion 12exclusions 13dependency 14 15 16dependency 17groupIdorg.springframework.bootgroupId 18artifactIdspring-boot-starter-jettyartifactId 19dependency 20dependencies第二步启动项目验证切换成功启动日志里会看到 Jetty 相关输出说明切换成功2026-03-19 10:01:00.000 INFO 67890 --- [ main] o.e.j.s.Server : jetty-11.0.18; built: 2024-01-01T00:00:00Z; git: abc123; jvm 17.0.10 2026-03-19 10:01:00.123 INFO 67890 --- [ main] o.e.j.w.StandardDescriptorProcessor : NO JSP Support for /, did not find org.eclipse.jetty.jsp.JettyJspServlet 2026-03-19 10:01:00.456 INFO 67890 --- [ main] o.s.b.web.embedded.jetty.JettyWebServer : Jetty started on port 8080 (http) with context path /第三步自定义 Jetty 配置可选在application.yml里调整 Jetty 参数1server: 2 jetty: 3acceptors:4# 接受连接的线程数默认CPU核心数 4selectors:8# 处理IO的线程数 5max-http-post-size: 10MB # 最大POST请求大小切换到 UndertowUndertow 是 RedHat 开源的服务器性能吊打 Tomcat/Jetty内存占用最低适合高并发的微服务接口。第一步排除 Tomcat 依赖引入 Undertow 依赖同样修改pom.xml1dependencies 2 3dependency 4groupIdorg.springframework.bootgroupId 5artifactIdspring-boot-starter-webartifactId 6 7exclusions 8exclusion 9groupIdorg.springframework.bootgroupId 10artifactIdspring-boot-starter-tomcatartifactId 11exclusion 12exclusions 13dependency 14 15 16dependency 17groupIdorg.springframework.bootgroupId 18artifactIdspring-boot-starter-undertowartifactId 19dependency 20dependencies第二步启动验证查看日志启动日志里出现 Undertow 标识说明切换成功2026-03-19 10:02:00.000 INFO 11223 --- [ main] io.undertow.servlet.core.ApplicationDeploymentManager : starting deployment of web application directory /tmp/tomcat.12345/webapps/ROOT 2026-03-19 10:02:00.345 INFO 11223 --- [ main] o.s.b.web.embedded.undertow.UndertowWebServer : Undertow started on port 8080 (http) with context path /第三步自定义 Undertow 配置性能调优Undertow 的性能调优主要在线程数和连接数配置application.yml1server: 2 undertow: 3# IO 线程数默认CPU核心数*2处理连接接受、请求分发 4io-threads:8 5# 工作线程数默认IO线程数*8处理具体的业务请求 6worker-threads:64 7# 最大请求大小 8max-http-post-size: 10MB 9# 开启HTTP2可选需要HTTPS 10 http2: 11enabled:true⚠️ 调优建议IO 线程数设为 CPU 核心数2工作线程数设为 IO 线程数8~16根据服务器配置调整。必避的 3 个坑只引入新服务器依赖没排除 Tomcat结果项目启动报错依赖冲突日志里同时出现 Tomcat 和 Jetty/Undertow解决必须先排除spring-boot-starter-tomcat再引入目标服务器依赖。切换后接口访问 404原因服务器切换不影响业务代码大概率是其他配置问题比如端口错、Controller 没扫描到解决检查server.port、主启动类包层级、RestController注解是否正确。Undertow 开启 HTTP2 但没配 HTTPS结果启动报错HTTP2 必须基于 HTTPS解决要么关闭 HTTP2要么配置 SSL 证书生产环境再配。生产环境选型建议按场景选不用盲目追求“高性能”按实际需求选新手/通用场景选 Tomcat文档多、问题好排查、兼容性最好WebSocket 应用聊天、推送选 Jetty对长连接支持更优高并发微服务接口选 Undertow性能最高、内存占用最低老项目迁移选 Tomcat和传统 Web 项目兼容最好容器化部署Docker/K8s选 Undertow镜像体积更小资源占用低。最后说两句SpringBoot 切换内置服务器的核心就两步排除默认的 Tomcat 依赖引入目标服务器Jetty/Undertow的 Starter 依赖。三款服务器没有“最好”只有“最适合”——大部分场景用 Tomcat 足够追求性能选 Undertow追求轻量选 Jetty。下一期咱们会讲SpringBoot 配置 HTTPS自签名证书正式证书让接口通过 HTTPS 访问保证数据传输安全。如果这篇文章帮你搞定了服务器切换麻烦点个赞、在看关注我后续还有更多 SpringBoot 性能调优实战技巧从入门到精通