springboot项目打war包,并部署到tomcat

软件版本:

idea:2019.1 ultimate

springboot: 2.2.5

tomcat:9.0.31

一、修改默认打包方式,讲打包方式改为war

    <version>0.0.1-SNAPSHOT</version>
    <name>infocollection</name>
    <description>Demo project for Spring Boot</description>

    <!--在打包到生产环境Tomcat时指明打包方式-->
    <packaging>war</packaging>

二、排除springboot内置的tomcat的容器

为什么要排除springboot内置tomcat呢?

因为如果不排除内置的tomcat,当我们打成war包发布到生产环境的tomcat时,就会出现两个tomcat冲突的问题。为了避免不必要的麻烦,所以这里排除内置的tomcat。

这里有两种方式可供选择:

  1. 使用<exclusion>标签,排除springboot中的内置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>
    
  2. 添加tomcat依赖,并设置<scope>provided,用来覆盖springboot中的tomcat的<scope>:

    <!--当打war包到tomcat时,自动排除内置的tomcat,避免二者产生冲突-->
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-tomcat</artifactId>
                <!--打包的时候可以不用包进去,别的设施会提供。事实上该依赖理论上可以参与编译,测试,运行等周期。
                    相当于compile,但是打包阶段做了exclude操作-->
                <scope>provided</scope>
            </dependency>
    

这里虽然有两种方法,但是明眼人一眼就可以看出来,当然是选择第二种好一些,虽然两种操作都可以在打war包时成功吧内置tom猫排除,但是第二种操作可以在打war之后,不修改任何代码,还是可以继续修改代码,继续使用内置tomcat测试代码。<font color="#FF0000" >所以这里墙裂推荐第二种方法。</font>

在springboot的官方文档上也是介绍使用第二种方法。这是原话:The final step in the process is to ensure that the embedded servlet container does not interfere with the servlet container to which the war file is deployed. <font color="#FF0000" >To do so, you need to mark the embedded servlet container dependency as being provided.</font>

三、继承SpringBootServletInitializer类,并重写config方法

全称:org.springframework.boot.web.servlet.support.SpringBootServletInitializer,官方文档也有详细介绍为什么要继承。

@SpringBootApplication
public class Application extends SpringBootServletInitializer {

    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
        return application.sources(Application.class);
    }

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

}

这里亲测,继承这个类之后,只是在部署war到生产环境时告诉tomcat自己的启动入口在哪。而如果你要修改代码并用内置tomcat测试,完全是不影响的,不用将代码还原回来。

四、端口,路径:

  1. 我们在application.properties或者在application.yml中对tomcat配置的portcontext-path对war文件是不起作用的,那个配置只对springboot内置的tomcat起作用。当我们把war部署到生产环境时,端口就是生产环境的端口,context-path就是war的文件名,或者自己在tomcat中配置的其他名字。

  2. 为了防止应用上下文所导致的项目访问资源加载不到的问题,

    建议pom.xml文件中<build></build>标签下添加<finalName></finalName>标签:

<build>
        <!--打war包到生产环境时配置-->
        <finalName>photoSystem</finalName>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

五、使用maven进行打包发布:

clean是清除之前的包,-Dmaven.test.skip=true是忽略测试代码

直接使用idea的maven插件进行打包发布:

image-20200312214230384.png

先进行clean清除target下面的文件,然后package将war包打包到target文件夹下。或者用install将war包打包到本地仓库中就好了。

六、结果:

image-20200312215103623.png

可以看到,这里有一个是war包,另一个是.original文件,其实这两个都是war包,把.original去掉,然后放到tomcat里面,照样可以运行。

其实他们两的区别就是,第一个war包里面的WEB-INF文件夹下有liblib-provided文件夹,lib-provided文件夹里面有spring中你排除的那个tomcat,所以war包也可以通过java -jar在命令行中启动。而.original中的WEB-INF下就只有lib文件夹,没有lib-provided文件夹。自然只能够通过tomcat来启动,而不能够通过命令行的java -jar来启动。所以我们在使用时,直接使用.war的文件就好了。

七、温馨提示:

建议springboot中的tomcat是什么版本,就在生成环境使用说明版本的tomcat,这样可以避免出现不必要的错误。

比如,现在的springboot内置的是tomcat9,而如果你把war丢到tomcat7 中运行,就会报错说找不到el-api.jar,这个其实不是tomcat7中没有这个jar包,而是tomcat9中的el-api.jar版本比较高,而tomcat7中不支持。

当然了,如果生产环境不允许的话,也可以把tomcat7中的lib进行调换即可。

这里最后放上springboot官方文档,直接讲述了如何发布war,有兴趣可以看看springboot传统发布方式

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 200,392评论 5 470
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 84,258评论 2 377
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 147,417评论 0 332
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 53,992评论 1 272
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 62,930评论 5 360
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,199评论 1 277
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,652评论 3 390
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,327评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,463评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,382评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,432评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,118评论 3 315
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,704评论 3 303
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,787评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,999评论 1 255
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,476评论 2 346
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,057评论 2 341

推荐阅读更多精彩内容