springboot打包成war部署到tomcat容器的方法

# SpringBoot打包成WAR部署到Tomcat容器的方法

## 前言

Spring Boot默認內嵌Tomcat服務器，通常以可執行JAR包形式運行。但在企業級生產環境中，我們可能需要將應用部署到獨立的外部Tomcat容器中。本文將詳細介紹如何將Spring Boot應用打包為WAR文件并部署到Tomcat服務器。

---

## 一、環境準備

在開始之前，請確保已安裝以下環境：

1. **JDK 8+**（推薦JDK 11或17）
2. **Apache Maven 3.5+** 或 **Gradle 6.x+**
3. **Tomcat 9.x+**（本文以Tomcat 9為例）
4. **IDE工具**（IntelliJ IDEA/Eclipse等）

---

## 二、修改項目配置

### 1. 修改打包方式

在`pom.xml`中將打包方式從`jar`改為`war`：

```xml
<packaging>war</packaging>

2. 排除內嵌Tomcat

添加以下依賴配置：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-tomcat</artifactId>
    <scope>provided</scope> <!-- 關鍵配置 -->
</dependency>

3. 繼承SpringBootServletInitializer

修改主啟動類，使其繼承SpringBootServletInitializer：

@SpringBootApplication
public class MyApplication extends SpringBootServletInitializer {
    
    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
        return builder.sources(MyApplication.class);
    }

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

三、解決常見問題

1. 靜態資源訪問問題

在application.properties中添加：

spring.mvc.servlet.path=/
spring.web.resources.static-locations=classpath:/static/

2. JSP支持（如需）

添加依賴：

<dependency>
    <groupId>org.apache.tomcat.embed</groupId>
    <artifactId>tomcat-embed-jasper</artifactId>
    <scope>provided</scope>
</dependency>

配置文件位置：

spring.mvc.view.prefix=/WEB-INF/views/
spring.mvc.view.suffix=.jsp

四、打包構建

執行Maven命令：

mvn clean package

構建成功后會在target目錄生成your-app-0.0.1.war文件。

五、Tomcat部署

1. 常規部署方式

將WAR文件復制到Tomcat的webapps目錄：

cp target/your-app.war ${TOMCAT_HOME}/webapps/

2. 通過Manager App部署

1. 訪問http://localhost:8080/manager/html
2. 在”WAR file to deploy”部分上傳文件
3. 點擊Deploy按鈕

3. 配置Context Path

修改conf/server.xml：

<Context path="/myapp" docBase="your-app" reloadable="true"/>

六、高級配置

1. 自定義WAR文件名

在pom.xml中配置：

<build>
    <finalName>custom-name</finalName>
</build>

2. 多環境配置

使用Profile區分環境：

<profiles>
    <profile>
        <id>dev</id>
        <properties>
            <spring.profiles.active>dev</spring.profiles.active>
        </properties>
    </profile>
</profiles>

3. 排除測試代碼

打包時跳過測試：

mvn package -DskipTests

七、性能優化建議

1. 連接池配置：

   spring.datasource.hikari.maximum-pool-size=20
   

2. Tomcat調優：

   <!-- 在conf/server.xml中 -->
   <Connector port="8080" maxThreads="200" minSpareThreads="10"/>
   

3. JVM參數：

   export JAVA_OPTS="-Xms512m -Xmx1024m -XX:+UseG1GC"
   

八、常見問題排查

1. 404錯誤

• 檢查Context Path配置
• 確認控制器@RequestMapping注解正確

2. 啟動失敗

• 查看logs/catalina.out
• 檢查JDK版本兼容性

3. 靜態資源加載失敗

• 檢查spring.resources.static-locations
• 確認資源文件在WAR包中的位置

九、替代方案比較

結語

通過本文的步驟，您應該已經成功將Spring Boot應用部署到獨立Tomcat容器。這種部署方式特別適合需要與傳統Java EE應用共存，或需要利用Tomcat高級功能（如集群、JMX監控等）的場景。

最佳實踐建議：對于新項目，除非有特殊需求，否則推薦使用Spring Boot默認的內嵌服務器方式。

”`

這篇文章包含約2200字，采用Markdown格式編寫，涵蓋了從環境準備到部署優化的完整流程。您可以根據實際需求調整各部分內容的深度或添加特定框架的配置細節。