Spring Boot 项目发布到 Tomcat 服务器

本文介绍如何将Spring Boot项目以WAR包形式部署到Tomcat服务器。包括配置项目打包方式、排除内置Tomcat、创建Servlet初始化子类及自定义WAR包名称等步骤。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

特别说明: tomcat版本必须7以上,我之前就是项目main方法运行一切正常,但把war包部署到tomcat6上,访问就报404找不到请求的路径。

第 1 步:将这个 Spring Boot 项目的打包方式设置为 war。

<packaging>war</packaging>

这里还要多说一句, SpringBoot 默认有内嵌的 tomcat 模块,因此,我们要把这一部分排除掉。
即:我们在 spring-boot-starter-web 里面排除了 spring-boot-starter-tomcat ,但是我们为了在本机测试方便,我们还要引入它,所以我们这样写:

  <dependencies>
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
      <!-- 打包部署到tomcat上面时,不需要打包tmocat相关的jar包,否则会引起jar包冲突 -->
      <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-tomcat</artifactId>
        </exclusion>
    </exclusions>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-tomcat</artifactId>
        <scope>provided</scope>
    </dependency>
</dependencies>

第 2 步:提供一个 SpringBootServletInitializer 子类,并覆盖它的 configure 方法。我们可以把应用的主类改为继承 SpringBootServletInitializer。或者另外写一个类。

@Configuration  
@ComponentScan  
@EnableAutoConfiguration  
public class Application extends SpringBootServletInitializer {

    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
        return application.sources(Application.class);
    }

    public static void main(String[] args) throws Exception {
        SpringApplication.run(Application.class, args);
    }
}

注意:部署到 tomcat 以后,访问这个项目的时候,须要带上这个项目的 war 包名。
另外,我们还可以使用 war 插件来定义打包以后的 war 包名称,以免 maven 为我们默认地起了一个带版本号的 war 包名称。例如:

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-war-plugin</artifactId>
    <configuration>
        <warName>springboot</warName>
    </configuration>
</plugin>

例如:
http://localhost:8080/springboot/user/18
其中,springboot 是我放在 tomcat 上的 war 包名。

<think>好的,用户想了解如何将Spring BootWeb应用部署到Tomcat服务器的教程。我需要整理一下步骤,确保涵盖所有必要环节,并参考提供的引用内容来确保准确性。首先,用户的问题集中在部署流程上,可能需要从项目配置开始讲起。根据引用内容,比如引用3和5,提到需要修改pom.xml文件,设置打包方式为war,并排除内嵌的Tomcat依赖。所以第一步应该是配置Maven的pom.xml,将打包方式改为war,并排除Tomcat,或者设置其scope为provided,这样在部署到外部Tomcat时就不会冲突。 接下来,引用3提到需要继承SpringBootServletInitializer类,并覆盖configure方法。这是为了让应用在外部Servlet容器中启动,所以用户需要修改主启动类,添加这部分代码。这部分很关键,否则应用可能无法正确初始化。然后,生成WAR包。用户可能熟悉使用Maven命令打包,比如mvnclean package,但需要确认是否配置正确,生成的文件是否正确放置在target目录下。可能需要提醒用户检查生成的WAR文件名,避免版本号等问题导致部署失败。部署到Tomcat部分,需要说明将WAR文件放到webapps目录下,并启动Tomcat服务器。这里可能需要提到Tomcat的版本兼容性,比如Tomcat10需要JakartaEE而不是javax,但SpringBoot可能已经处理了这部分,不过用户需要注意版本匹配,避免出现类冲突。 另外,引用4和5提到了替换容器为Jetty的情况,但用户的问题是关于Tomcat的,所以这部分可能不需要,但可以提及如果有需要排除Tomcat的情况,如何操作,但当前问题可能不需要,所以可能不需要展开。 测试部分,用户可能需要知道如何访问应用,比如通过正确的URL,以及查看Tomcat的日志文件来排查问题。比如,应用部署后,默认的上下文路径可能和内置的不同,需要提示用户检查。可能还需要注意事项,比如上下文路径的配置,或者是否需要对application.properties进行调整,比如server.servlet.context-path,但部署到外部Tomcat时,上下文路径由Tomcat决定,通常是WAR文件名,或者可以在Tomcat的配置中修改。总结一下,步骤应该是:修改pom.xml配置,调整启动类,打包WAR,部署到Tomcat,测试访问。同时需要引用相关的引用内容来支持每个步骤,比如引用3和5中的代码示例,引用2中的外部教程链接可能可以作为补充参考。 需要确保回答结构清晰,分步骤说明,每个步骤的代码示例正确,并引用对应的引用来源。此外,生成的相关问题可能需要涉及常见错误、性能优化、日志查看等,帮助用户进一步了解可能出现的问题和扩展知识。</think>### 如何将Spring Boot Web应用部署到Tomcat服务器? 以下是分步指南,结合引用内容整理: --- #### **1. 修改项目配置(POM.XML)** - **设置打包类型为WAR**: 在`pom.xml`中添加`<packaging>war</packaging>`,明确项目输出格式[^5]。 - **排除嵌入式Tomcat依赖**: 若需使用外部Tomcat,需排除Spring Boot默认的嵌入式Tomcat: ```xml <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> <exclusions> <exclusion> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-tomcat</artifactId> </exclusion> </exclusions> </dependency> <!-- 添加Tomcat依赖(Scope为provided) --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-tomcat</artifactId> <scope>provided</scope> </dependency> ``` 此操作确保Tomcat由外部服务器提供,而非嵌入应用[^4][^5]。 --- #### **2. 修改主启动类** - **继承`SpringBootServletInitializer`**: 主类需覆盖`configure`方法,以支持外部Servlet容器初始化: ```java @SpringBootApplication public class Application extends SpringBootServletInitializer { @Override protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) { return builder.sources(Application.class); } public static void main(String[] args) { SpringApplication.run(Application.class, args); } } ``` 此步骤是部署到外部Tomcat的关键[^3]。 --- #### **3. 生成WAR包** - **使用Maven命令打包**: 执行`mvn clean package`,生成的WAR文件位于`target`目录下。 **注意**:生成的WAR文件名默认与`<artifactId>`和`<version>`相关,需确保文件名无冲突[^2]。 --- #### **4. 部署到Tomcat服务器** - **复制WAR文件到Tomcat的`webapps`目录**: 将生成的WAR文件放入Tomcat安装路径下的`webapps`文件夹中。 - **启动Tomcat**: 执行`bin/startup.sh`(Linux)或`bin\startup.bat`(Windows),Tomcat会自动解压并部署应用[^1][^2]。 --- #### **5. 验证部署** - **访问应用**: 默认上下文路径为WAR文件名(不含版本号),例如:`http://localhost:8080/your-app-name/`。 - **查看日志**: 检查`logs/catalina.out`或应用专属日志文件,排查启动错误[^2]。 --- #### **注意事项** - **Tomcat版本兼容性**: Spring Boot 2.x+需搭配Tomcat 9+,若使用Tomcat 10需确认Jakarta EE包名迁移问题(如`javax`改为`jakarta`)[^2]。 - **上下文路径配置**: 可在`application.properties`中设置`server.servlet.context-path=/path`,但实际路径可能受Tomcat配置影响。 --- ### 相关问题 1. 如何解决Spring Boot WAR包部署到Tomcat后访问404错误? 2. 如何将Spring Boot应用同时支持嵌入式Tomcat和外部部署? 3. Tomcat服务器启动时如何指定应用端口或内存参数? 4. 如何通过Maven多环境配置生成不同版本的WAR包? --- 参考引用: [^1]: Spring Boot基础部署流程 [^2]: 外部Tomcat部署实战指南 [^3]: 主类继承`SpringBootServletInitializer`的必要性 [^5]: POM文件配置细节
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值