對於傳統的 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>
需要特別注意的是:
- 雖然 spring-boot-starter-web 內嵌 tomcat,但是,內嵌的 spring-boot-starter-tomcat 僅僅包含了 tomcat-embed-core,而不包含 tomcat-embed-jasper。因此需要單獨添加該依賴。
- 使用外部 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>
總結
- 默認目前一般都直接打成 jar 包進行部署。
- 如果需要部署 war 包的,最簡單的方法就是 pom 中加上
war ,以及添加 ServletInitializer 文件(必須)。 - 如果有需要 JSP 的,添加 tomcat-embed-jasper 和其他需要的依賴。
- 至於上文中或者其他博客上提到的,需要在 web 包中排除 tomcat,或者 jasper 的 scope 必須是 provided,其實經過測試,改了和沒改都一樣。(沒發生衝突的話,無關緊要;出錯了,特別注意這裏兩個地方就可以了)