快捷導(dǎo)航

SpringBoot使用外置Tomcat的操作步驟

更新時間：2026年02月05日 08:24:39 作者：好好研究

這篇文章主要介紹了Spring Boot如何使用外置Tomcat,包括創(chuàng)建Maven Web項(xiàng)目、修改為Spring Boot項(xiàng)目、配置外部Tomcat和啟動外部Tomcat,需要的朋友可以參考下

SpringBoot默認(rèn)使用嵌入式Servlet容器（內(nèi)置Tomcat）。

應(yīng)用打成可執(zhí)行的jar。

原理：

jar包：執(zhí)行SpringBoot主類的main方法，啟動ioc容器，創(chuàng)建嵌入式的Servlet容器。

war包：啟動服務(wù)器，服務(wù)器啟動SpringBoot應(yīng)用【SpringBootServletInitializer】，啟動ioc容器。

如果SpringBoot想要使用外置Tomcat應(yīng)如何操作呢？下面進(jìn)行外置Tomcat的步驟演示：

第一步：創(chuàng)建Maven Web項(xiàng)目

第二步：將Maven Web項(xiàng)目修改為SpringBoot項(xiàng)目

【1. 修改pom.xml文件】

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.5.6</version>
    <relativePath/> <!-- lookup parent from repository -->
  </parent>

  <groupId>com.qcby</groupId>
  <artifactId>springboottomcat</artifactId>
  <version>1.0-SNAPSHOT</version>
  <packaging>war</packaging><!-- 注意這里是war的打包方式 -->

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>8</maven.compiler.source>
    <maven.compiler.target>8</maven.compiler.target>
  </properties>

  <dependencies>
    <!-- Web依賴 -->
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
      <!-- 排除內(nèi)置的Tomcat依賴 -->
      <exclusions>
        <exclusion>
          <groupId>org.springframework.boot</groupId>
          <artifactId>spring-boot-starter-tomcat</artifactId>
        </exclusion>
      </exclusions>
    </dependency>

    <!-- 將嵌入式的Tomcat指定為provided -->
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring‐boot‐starter‐tomcat</artifactId>
      <scope>provided</scope>
    </dependency>

    <!-- 添加Servlet API依賴（provided表示打包時不包含，由外置容器提供） -->
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>javax.servlet-api</artifactId>
      <version>4.0.1</version>
      <scope>provided</scope>
    </dependency>
  </dependencies>

  <!-- Spring Boot Maven插件，這是生成可執(zhí)行jar的關(guān)鍵 -->
  <build>
    <plugins>
      <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
      </plugin>
    </plugins>
  </build>
</project>

【2. 添加啟動類，適配外置容器】

注意：讓啟動類繼承SpringBootServletInitializer并重寫configure方法（這是外置容器啟動SpringBoot應(yīng)用的入口）

package com.qcby.springBootTomcat;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.builder.SpringApplicationBuilder;
import org.springframework.boot.web.servlet.support.SpringBootServletInitializer;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@SpringBootApplication
public class springBootTomcat extends SpringBootServletInitializer{
    // 內(nèi)置容器啟動入口（保留不影響，外置容器不會走這個方法）
    public static void main(String[] args) {
        SpringApplication.run(springBootTomcat.class,args);
    }

    // 外置容器啟動入口：重寫configure方法
    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
        return application.sources(springBootTomcat.class);
    }
}

【3. 寫一個測試接口】

@RestController
public class HelloController {
    // 測試接口
    @GetMapping("/hello")
    public String hello() {
        return "Hello, Tomcat!";
    }
}

第三步：配置外部Tomcat