如何將spring boot項目打包成war包

聲明：參考自 如何將spring boot項目打包成war包

一、修改打包形式

在 pom.xml 里設置 <packaging>war</packaging>

二、移除嵌入式tomcat插件

在 pom.xml 里找到spring-boot-starter-web依賴，在其中添加如下代碼，

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <!-- 移除嵌入式tomcat插件 -->
    <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-tomcat</artifactId>
        </exclusion>
    </exclusions>
</dependency>

三、添加servlet-api的依賴

在 pom.xml 中新增以下依賴：

<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <version>3.1.0</version>
    <scope>provided</scope>
</dependency>

四、修改啟動類，並重寫初始化方法

我們平常用 main 方法啟動的方式，都有一個App的啟動類，代碼如下：

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

我們需要類似於web.xml 的配置方式來啟動 Spring 上下文了，在 Application 類的同級添加一個SpringBootStartApplication類，其代碼如下:

import org.springframework.boot.builder.SpringApplicationBuilder;
import org.springframework.boot.web.servlet.support.SpringBootServletInitializer;

/**
 * 修改啟動類，繼承 SpringBootServletInitializer 並重寫 configure 方法
 */
public class SpringBootStartApplication extends SpringBootServletInitializer {

    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
        // 注意這里要指向原先用main方法執行的Application啟動類
        return builder.sources(Application.class);
    }
}

五、打包部署

5.1 打war包

在項目根目錄下（即包含pom.xml的目錄），在命令行里輸入：
mvn clean package -Dmaven.test.skip=true 即可， 等待打包完成，出現 [INFO] BUILD SUCCESS 即為打包成功。

5.2 部署

然后把target目錄下的war包放到 tomcat 的 webapps 目錄下，啟動 tomcat，即可自動解壓部署。
最后在瀏覽器中輸入

http://localhost:[端口號]/[打包項目名]/

發布成功

六、其他報錯

6.1 webxml attribute is required

[ERROR] Failed to execute goal org.apache.maven.plugins:maven-war-plugin:2.2:war (default-war) on project war-application: Error assembling WAR: webxml attribute is required (or pre-existing WEB-INF/web.xml if executing in update mode)

解決方案：
在 pom.xml 中指定 maven-war-plugins 插件的版本。

<project>
  ...
  <build>
    <plugins>
      <!-- https://maven.apache.org/plugins/maven-war-plugin/index.html -->
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-war-plugin</artifactId>
        <!-- 從 3.1.0 開始，failOnMissingWebXml 默認是 false，因此這里就是特地指定版本-->
        <version>3.1.0</version>
        <configuration>
          <warName>${project.artifactId}</warName>
          <failOnMissingWebXml>false</failOnMissingWebXml>
        </configuration>
      </plugin>
    </plugins>
  </build>
  ...
</project>