若是使用的是 SpringBoot 多模塊的項目,在發佈的時候可能遇到各類各樣的問題。本文概括瞭如下 8 個原則和發佈時常常出現的 4 個問題的解決方案,掌握了這些原則和解決方案,幾乎能夠解決絕大數 SpringBoot 發佈問題。html
好比,如下項目目錄:
若是要發佈 api 就直接在它的模塊上打包,而不是在父模塊上打包。web
公共模塊,好比 common 和 model 須要設置 packaging 爲 jar 格式,在 pom.xml 配置:spring
<packaging>jar</packaging>
在發佈的模塊 pom.xml 中設置:api
<packaging>war</packaging>
在發佈的模塊 pom.xml 中設置:tomcat
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-tomcat</artifactId> <scope>provided</scope> </dependency>
當設置 scope=provided 時,此 jar 包不會出如今發佈的項目中,從而就排除了內置的 tomcat。markdown
此步驟至關於告訴 tomcat 啓動的入口在哪。須要在啓動類添加以下代碼:app
@SpringBootApplication public class ApiApplication extends SpringBootServletInitializer { @Override protected SpringApplicationBuilder configure ( SpringApplicationBuilder application ) { return application . sources ( ApiApplication . class ); } public static void main ( String [] args ) { SpringApplication . run ( ApiApplication . class , args ); }
好比我在項目中使用了 swagger,那我就須要排除 swagger 的靜態文件,代碼以下:webapp
@Configuration public class WebMvcConfig extends WebMvcConfigurationSupport { @Override protected void addResourceHandlers ( ResourceHandlerRegistry registry ) { // 排除靜態文件 registry . addResourceHandler ( "swagger-ui.html" ) . addResourceLocations ( "classpath:/META-INF/resources/" ); registry . addResourceHandler ( "/webjars/**" ) . addResourceLocations ( "classpath:/META-INF/resources/webjars/" ); } // do something }
若是發佈的模塊引用了本項目的其餘公共模塊,須要先把本項目的公共模塊裝載到本地倉庫。
操做方式,雙擊父模塊的 install 便可, install 成功以後,點擊發布模塊的 package 生成 war 包,就完成了項目的打包,以下圖所示:maven
有了 war 包以後,只須要把單個 war 包,放入 tomcat 的 webapps 目錄,從新啓動 tomcat 便可,以下圖所示:
項目正常運行會在 webapps 目錄下生成同名的文件夾,以下圖所示:
完成以上配置,就能夠 happy 的訪問本身發佈的項目了。ide
可能出現的問題和解決方案
問題一:SpringBoot 配置了端口號影不影響程序發佈?
答:不影響,配置的 server.port 會被覆蓋,以 tomcat 自己的端口號爲準,tomcat 端口號在
tomcat/config/server.xml 文件中配置。
問題二:發佈報錯,不能找到其餘模塊或項目中的公共模塊,怎麼辦?
答:由於沒有執行父節點 maven 的 install 操做,install 就是把公共模塊放入本地倉庫,提供給其它項目使用。
問題三:不能找到 SpringBoot 運行的 main 類,怎麼辦?
答:由於沒有設置啓動類致使的,設置方式:
pom.xml 配置啓動類,配置
configuration>com.bi.api.ApiApplication
。 啓動類繼承 SpringBootServletInitializer 實現 SpringApplicationBuilder
方法,具體代碼參考文中第五部分。
問題四:把 SpringBoot 項目部署到 Tomcat 7 一直提示找不到 xxx.jar 包?
答:這是由於 SpringBoot 版本過高,tomcat 版本過低的緣由。若是你使用的是最新版的 SpringBoot,能夠考慮把tomcat 也升級爲 tomcat 8.x+ 最新的版本,就能夠解決這個問題。