讲师中心 微信公众号
AI工具推荐 视频效率加速

Spring Boot 中怎么配置外部 Tomcat 容器部署运行

夏浩姑娘_6195

夏浩姑娘_6195

发布时间:2026-08-11 11:46:08

|

964人浏览过

|

来源于php中文网

原创

Spring Boot 项目需改造成 WAR 包并部署到外部 Tomcat,核心是三步:①修改 pom.xml 的 packaging 为 war;②排除 spring-boot-starter-tomcat 依赖;③主类继承 SpringBootServletInitializer 并重写 configure 方法。

spring boot 中怎么配置外部 tomcat 容器部署运行

Spring Boot 默认使用内置 Tomcat,要让它运行在外部独立的 Tomcat 容器中,核心是把项目从可执行 JAR 改为标准 WAR 包,并让 Spring Boot 主动适配 Servlet 容器的生命周期。这不是简单改个配置就能跑通,而是涉及打包方式、依赖调整和启动逻辑三处关键改动。

修改打包类型为 WAR

这是第一步,也是最基础的标识。打开 pom.xml,将原本的:

<packaging>jar</packaging>

改为:

<packaging>war</packaging>

这告诉 Maven 构建系统:本项目要生成一个符合 Servlet 规范的 Web 归档包,而非自包含的可执行 JAR。

排除内置 Tomcat 依赖

Spring Boot 的 spring-boot-starter-web 默认带了嵌入式 Tomcat(spring-boot-starter-tomcat)。外部 Tomcat 运行时,这个依赖不仅多余,还会引发类加载冲突或端口绑定异常。

需在 spring-boot-starter-web 中显式排除它:

Spring Boot Actuator Analyzer
Spring Boot Actuator Analyzer

分析Spring Boot Actuator端点的安全性、健康检查、指标暴露及生产配置——审计信息、健康状态和自定义端点。

下载
  • 找到该依赖节点
  • 添加 <exclusions> 块,移除 spring-boot-starter-tomcat

示例片段:

<dependency><br>  <groupId>org.springframework.boot</groupId><br>  <artifactId>spring-boot-starter-web</artifactId><br>  <exclusions><br>    <exclusion><br>      <groupId>org.springframework.boot</groupId><br>      <artifactId>spring-boot-starter-tomcat</artifactId><br>    </exclusion><br>  </exclusions><br></dependency>

继承 SpringBootServletInitializer 并重写 configure 方法

外部 Tomcat 启动时,会调用标准的 ServletContainerInitializer 流程,而不是直接执行你的 main 方法。因此,主启动类必须适配这一机制:

  • 让启动类继承 SpringBootServletInitializer
  • 重写 configure(SpringApplicationBuilder) 方法,返回指向自身类的 builder.sources(...)
  • 保留原有的 main 方法(本地调试仍可用)

代码示意:

@SpringBootApplication<br>public class Application extends SpringBootServletInitializer {<br>  @Override<br>  protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {<br>    return builder.sources(Application.class);<br>  }<br><br>  public static void main(String[] args) {<br>    SpringApplication.run(Application.class, args);<br>  }<br>}

可选但推荐:添加 servlet-api 编译依赖

虽然 Spring Boot 2.4+ 对此要求已放宽,但为兼容性与 IDE 提示清晰,建议显式声明 Servlet API 依赖,并设为 provided(由外部 Tomcat 提供,不打入 WAR):

<dependency><br>  <groupId>javax.servlet</groupId><br>  <artifactId>servlet-api</artifactId><br>  <version>4.0.1</version><br>  <scope>provided</scope><br></dependency>

注意:若使用 Jakarta EE 9+(如 Tomcat 10),应改用 jakarta.servlet:jakarta.servlet-api。

热门AI工具

更多
LibLibAI
LibLibAI Hot

一款AI视频创作工具,主要用于国内领先的AI创意平台,以海量模型、低门槛操作与“创作-分享-商业化”生态,让小白与专业创作者都能高效实现图文乃至视频创意表达,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
如何配置Tomcat环境变量
如何配置Tomcat环境变量

配置Tomcat环境变量需要在系统中添加CATALINA_HOME变量,并将Tomcat的安装路径添加到PATH变量中。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

745

2023.10.26

idea如何集成Tomcat
idea如何集成Tomcat

idea集成Tomcat的步骤:1、添加Tomcat服务器配置;2、配置项目部署;3、运行Tomcat服务器;4、访问项目;5、注意事项;6、关闭Tomcat服务器。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

304

2024.02.23

怎么查看Tomcat源代码
怎么查看Tomcat源代码

查看Tomcat源代码的步骤:1、下载Tomcat源代码;2、在IDEA中导入Tomcat源代码;3、查看源代码;4、理解Tomcat的工作原理;5、参与社区和贡献;6、注意事项;7、持续学习和更新;8、使用工具和插件。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

489

2024.02.23

常见的tomcat漏洞有哪些
常见的tomcat漏洞有哪些

常见的tomcat漏洞有:1、跨站脚本攻击;2、跨站请求伪造;3、目录遍历漏洞;4、缓冲区溢出漏洞;5、配置漏洞;6、第三方组件漏洞。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

285

2024.02.23

tomcat日志乱码怎么解决
tomcat日志乱码怎么解决

tomcat日志乱码的解决办法:1、修改tomcat的日志编码设置;2、检查ide的编码设置;3、检查操作系统的编码设置;4、使用过滤器处理日志;5、检查外部系统的编码设置;6、检查文件编码方式等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

348

2024.02.23

weblogic和tomcat有哪些区别
weblogic和tomcat有哪些区别

weblogic和tomcat的区别:1、功能;2、性能;3、规模;4、价格;5、安全性;6、配置和管理;7、社区支持;8、集成能力;9、升级和更新;10、可靠性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

329

2024.02.23

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

561

2024.02.23

tomcat启动闪退怎么解决
tomcat启动闪退怎么解决

tomcat启动闪退的解决办法:1、检查java环境;2、检查环境变量配置;3、检查端口被占用;4、检查配置文件编码;5、检查启动时需要的配置文件;6、检查相关文件是否丢失;7、检查防火墙和杀毒软件设置。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

302

2024.02.23

Kratos框架HTTP与gRPC服务开发教程
Kratos框架HTTP与gRPC服务开发教程

本专题围绕Kratos框架双协议服务开发,涵盖HTTP路由与处理器编写、参数获取、gRPC服务实现与客户端调用、metadata上下文传递、encoding编解码注册、统一响应封装、超时控制与流式响应实现方法。

0

2026.10.10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn