SpringBoot部署Tomcat详细步骤解析
时间:2025-07-12 11:42:30 118浏览 收藏
本篇文章向大家介绍《Spring Boot部署Tomcat的完整教程》,主要包括,具有一定的参考价值,需要的朋友可以参考一下。
部署Spring Boot项目到外部Tomcat服务器需调整打包方式和配置。1. 修改pom.xml中的打包方式为war,并将内嵌Tomcat依赖设为provided;2. 创建继承SpringBootServletInitializer的类以确保应用正确启动;3. 生成war包后部署到Tomcat的webapps目录;4. 注意Tomcat版本兼容性、JSP依赖及日志检查,应用路径通常与war包名一致。按照步骤操作可顺利完成部署。
部署Spring Boot项目到Tomcat服务器其实并不难,但有些细节容易被忽略。Spring Boot默认使用内嵌的Tomcat,所以如果你要部署到外部的Tomcat服务器,需要做一些调整。下面是一些关键步骤和注意事项。

修改打包方式为war
Spring Boot默认是打成可执行jar包运行的,而部署到外部Tomcat需要用war包格式。你需要在pom.xml
中做两件事:

把
标签改成war
:war 确保Spring Boot的内嵌Tomcat依赖设置为
provided
,这样它不会被打进最终的war包里:org.springframework.boot spring-boot-starter-tomcat provided
这一步做完之后,再执行mvn clean package
,就会生成一个标准的war文件了。
编写ServletInitializer类
为了让你的Spring Boot应用能在外部Tomcat中启动,需要添加一个继承自SpringBootServletInitializer
的类。这个类会告诉Tomcat如何加载Spring Boot应用。
示例代码如下:
import org.springframework.boot.builder.SpringApplicationBuilder; import org.springframework.boot.web.servlet.support.SpringBootServletInitializer; public class ApplicationInitializer extends SpringBootServletInitializer { @Override protected void configure(SpringApplicationBuilder builder) { builder.sources(Application.class); // 这里的Application是你主类 } }
这个类不需要加任何注解,只要存在就行。有了它,Tomcat在启动时就能正确初始化Spring上下文。
部署到Tomcat并检查配置
生成war包之后,就可以把它放到Tomcat的webapps
目录下,然后启动Tomcat。Tomcat会自动解压war文件,并部署你的应用。
几点需要注意的地方:
- Tomcat版本最好和Spring Boot兼容,一般推荐用Tomcat 9或以上。
- 如果你用了JSP页面,可能需要额外添加一些依赖,比如
tomcat-embed-jasper
。 - 检查日志文件(如
catalina.out
),看有没有启动错误。 - 应用访问路径通常是war包的名字,比如你生成的是
myapp.war
,那访问地址就是http://localhost:8080/myapp
。
基本上就这些。整个过程不算复杂,但有几个关键点不能漏掉,尤其是打包方式和ServletInitializer的编写。只要按照上面的步骤一步步来,大多数情况下都能顺利部署成功。
以上就是本文的全部内容了,是否有顺利帮助你解决问题?若是能给你带来学习上的帮助,请大家多多支持golang学习网!更多关于文章的相关知识,也可关注golang学习网公众号。
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
105 收藏
-
423 收藏
-
177 收藏
-
181 收藏
-
141 收藏
-
140 收藏
-
467 收藏
-
296 收藏
-
381 收藏
-
344 收藏
-
370 收藏
-
266 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 542次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 511次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 498次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 484次学习