当前位置：首页 > ops >正文

SpringBoot项目打包成war包

ops 2025/7/6 13:19:15

Spring Boot默认生成独立的JAR文件，但有时我们需要将Spring Boot应用部署到传统的Servlet容器（如Tomcat、Jetty）中，这时就需要将Spring Boot应用打包成WAR文件。本文将详细介绍如何将Spring Boot项目打包成WAR包。

一、修改POM文件

首先，确保你的项目是基于Maven构建的，并且需要对 pom.xml文件进行以下几处修改：

1.1 更改打包方式

将默认的打包方式从JAR改为WAR。

<packaging>war</packaging>

1.2 添加Tomcat依赖

在 dependencies节点中添加Tomcat依赖，并将其作用域设置为 provided，这样Tomcat不会被打包到WAR文件中。

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

1.3 排除嵌入式Tomcat

如果你的项目中包含嵌入式Tomcat依赖，需要将其排除。

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

完整的 pom.xml示例如下：

<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><groupId>com.example</groupId><artifactId>demo</artifactId><version>0.0.1-SNAPSHOT</version><packaging>war</packaging><parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>2.5.4</version><relativePath/> <!-- lookup parent from repository --></parent><properties><java.version>11</java.version></properties><dependencies><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><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-tomcat</artifactId><scope>provided</scope></dependency><!-- 其他依赖 --></dependencies><build><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId></plugin></plugins></build>
</project>

二、修改启动类

为了支持WAR包部署，需要修改Spring Boot应用的启动类，使其继承 SpringBootServletInitializer并重写 configure方法。

package com.example.demo;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;@SpringBootApplication
public class DemoApplication extends SpringBootServletInitializer {@Overrideprotected SpringApplicationBuilder configure(SpringApplicationBuilder application) {return application.sources(DemoApplication.class);}public static void main(String[] args) {SpringApplication.run(DemoApplication.class, args);}
}