Spring Boot 部署淺析（jar or war）

對於傳統的 ssm 或者 ssh 項目的部署，通常會打包成war包，或者是一個編譯好的文件夾，再放到 tomcat 的 webapps 目錄下，若是是 war 包，會自動解壓出來。而 Spring Boot 默認會內嵌一個 Tomcat，所以即使是 web 項目也能夠直接打包成 jar 包，直接 java -jar 運行就能夠了。

用 Spring Initialzr 建立的 web 項目（選擇打包成 jar），只會有一個 spring-boot-starter-web 依賴。

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

跟進去能夠發現 這個依賴包括了 spring-boot-starter-tomcat 這個（內嵌tomcat的依賴包）。若是使用內部的 tomcat 部署，那麼不須要對代碼進行修改，直接 run xxApplication下的 Main 方法。

若是建立的是 war 的 web 項目，默認會多一個 ServletInitializer 文件，maven 會多一個 spring-boot-starter-tomcat 依賴。war 的項目，既能夠用 Main 方法啓動，也能夠用外部的 tomcat 啓動。

這樣看來沒有任何問題，若是以前建工程用的是 jar，最終須要用外部 tomcat 部署的，只須要進行以下修改：

// 1. 添加一個 ServletInitializer.java
// 2. Maven 中添加<packaging>war</packaging>。（默認是 jar）
// 3. 添加 spring-boot-starter-tomcat 依賴。（測試過，不加也不要緊，可是既然 Spring Initialzr 建立時就自帶了，仍是加上好了）

若是你用的是 JSP，或許會有一些小問題。

通常博客都會寫，若是須要用到 JSP，須要添加個依賴 tomcat-embed-jasper：

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

須要特別注意的是：

1. 雖然 spring-boot-starter-web 內嵌 tomcat，可是，內嵌的 spring-boot-starter-tomcat 僅僅包含了 tomcat-embed-core，而不包含 tomcat-embed-jasper。所以須要單獨添加該依賴。
2. 使用外部 tomcat 部署，而且用到了 JSP 的，須要有如下配置：

<!--  把 web 中內嵌的 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>

<!--  注意 tomcat-embed-jasper 的scope。（在編譯測試的時候須要這個依賴的參與，可是在部署的時候 tomcat自己就有，這裏也是防止衝突） -->
<dependency>
    <groupId>org.apache.tomcat.embed</groupId>
    <artifactId>tomcat-embed-jasper</artifactId>
    <scope>provided</scope>
</dependency>

總結

1. 默認目前通常都直接打成 jar 包進行部署。
2. 若是須要部署 war 包的，最簡單的方法就是 pom 中加上 war ，以及添加 ServletInitializer 文件（必須）。
3. 若是有須要 JSP 的，添加 tomcat-embed-jasper 和其餘須要的依賴。
4. 至於上文中或者其餘博客上提到的，須要在 web 包中排除 tomcat，或者 jasper 的 scope 必須是 provided，其實通過測試，改了和沒改都同樣。（沒發生衝突的話，可有可無；出錯了，特別注意這裏兩個地方就能夠了）

參考文獻

• springboot embedded tomcat and tomcat-embed-jasper
• Spring Boot：內置tomcat啓動和外部tomcat部署總結