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

夏浩姑娘_6195

夏浩姑娘_6195

2026-08-11

964人浏览

原创

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></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。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

java tomcat spring boot

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

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

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

2023.10.26

725

5

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

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

2024.02.23

304

5

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

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

2024.02.23

489

5

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

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

2024.02.23

285

5

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

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

2024.02.23

328

5

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

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

2024.02.23

329

5

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

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

2024.02.23

561

5

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

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

2024.02.23

302

5

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

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

2024.02.23

2433

5

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共0课时 | 0人学习