当前位置：首页 > 文章列表 > 文章 > java教程 > SpringBoot部署Tomcat详细教程

SpringBoot部署Tomcat详细教程

2025-07-07 20:51:37 0浏览收藏

想要将Spring Boot项目部署到外部Tomcat服务器？本文为你提供详细的步骤和注意事项，助你轻松完成部署。首先，你需要修改`pom.xml`文件，将打包方式改为`war`，并将内嵌Tomcat依赖设置为`provided`，防止其被打入最终war包。其次，创建一个继承`SpringBootServletInitializer`的类，确保Tomcat能够正确加载Spring Boot应用。生成war包后，将其部署到Tomcat的`webapps`目录下。最后，别忘了检查Tomcat版本兼容性、JSP依赖以及日志文件，应用访问路径通常与war包名一致。按照这些步骤操作，你就能顺利地将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服务器其实并不难，但有些细节容易被忽略。Spring Boot默认使用内嵌的Tomcat，所以如果你要部署到外部的Tomcat服务器，需要做一些调整。下面是一些关键步骤和注意事项。

修改打包方式为war

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

把标签改成war：
```
<packaging>war</packaging>
```

确保Spring Boot的内嵌Tomcat依赖设置为provided，这样它不会被打进最终的war包里：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-tomcat</artifactId>
    <scope>provided</scope>
</dependency>

这一步做完之后，再执行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上下文。