IDEA Spring boot Maven打包发布

Posted lpq22221314

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了IDEA Spring boot Maven打包发布相关的知识,希望对你有一定的参考价值。

1、在pom.xml中如果要打war包,必须加上该行代码。

<packaging>war</packaging>

 

 

 

2、pom.xml中继续加入以下代码:该代码用于spring boot中内嵌的tomcat包依赖排除,不然会产生冲突。

<exclusions>
   <exclusion>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-tomcat</artifactId>
   </exclusion>
</exclusions>

 

3、pom.xml中继续加入以下依赖:该代码用于开发时使用spring boot内嵌tomcat进行调试,生产时使用外部tomcat

scope里的provided意思是只用于开发及测试阶段。

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-tomcat</artifactId>
    <scope>provided</scope>
</dependency>

  

4、找到项目中的application 然后让该类继承SpringBootServletInitializer,然后重写configure方法,如下图所示:

 

 

 

到这里,目前项目中需要打包配置的步骤已经完成,接下来进行打包

1、点击idea右边的maven(通过菜单View->Tool Windows->Maven Projects打开)-》你的项目名-》Lifecycle-》双击package

 

 

 

如果要引入外部手工导入的包,也要一起打包生成,则需要做以下的操作:

==================================================================================

 

 

1.前言
        SpringBoot和Maven的出现给我们的开发提供了很大的方便,正所谓事物都有两面性,有简便的地方就会有麻烦的地方,这里记录了一次使用Maven打包SpringBoot项目的时候出现的一个引用本地第三方jar包的问题。

2.问题描述
        一个SpringBoot项目,平时引用第三方jar包的时候,在pom文件里指定好该jar包的依赖就可以了,这本就是maven的一个很正常的操作,配置好依赖,maven自动将相应的jar包加入工程里,开发的时候就可以直接引入jar包内的类和方法,打包的时候maven还会将依赖的jar包打入到WEB-INF/lib下,皆大欢喜,多么开心~
        但总有那么个项目,由于一些列原因,必须要引入其他人提供给你的jar包,这些包是公有仓库上不存在的,如果有私服的还好,没有私服的就开始头疼了。
        有人说了,在本地maven仓库中新建目录,自定义一个路径把jar包放进去,然后在pom.xml里加上对应的<dependency>配置就可以了吧!这样的确是可以了,但这种方式不利于项目团队开发和工程源代码留存,并不能做到下载下来的工程代码直接就能编译运行的效果,所以考虑到代码的完整性,这个方案pass掉了。
        通过查阅一些相关资料,发现在<dependency>中使用<systemPath>就可以做到引用第三方jar包的效果,然后在spring-boot-maven-plugin中设置includeSystemScope为true就可以了,像下面这样:

 

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.st.springboot</groupId>
    <artifactId>ingredients-java</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>war</packaging>
    
    <name>ingredients-java</name>
    
	<dependencies>
		<dependency>
	        <groupId>org.bouncycastle</groupId>
	        <artifactId>bcprov-jdk16</artifactId>
	        <version>1.46</version>
	        <scope>system</scope>
	        <systemPath>${project.basedir}/src/main/resources/jar/bcprov-jdk16-1.46.jar</systemPath>
	    </dependency>
    </dependencies>
	<build>
		<plugins>
			<plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <includeSystemScope>true</includeSystemScope>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project> 

  

 设置完了非常开心,如果用的是idea,甚至还能看到IDE连包里的内容都能显示:

 

 

本以为皆大欢喜了,然而在程序开发完毕,打包部署的时候出现了问题,发现引用的本地jar包压根就打不进WEB-INF的lib目录下,jar包还在工程原来的位置放着了!

3.解决问题
        时间紧迫,先把所有引用的jar包往war包的lib目录下放进去吧,这么做确实好使,war包成功部署上去了。但一直这样不行啊,根本问题没有解决,万一有朝一日打算设置个maven定时自动打包部署什么的不就凉凉了……
        继续查阅资料寻找解决方法,终于功夫不负有心人,maven提供了插件专门解决打war包的时候引用本地包的问题,这东西叫做maven-war-plugin!
于是我的pom.xml变成了下面这样子:

 

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.st.springboot</groupId>
    <artifactId>ingredients-java</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>war</packaging>
    
    <name>ingredients-java</name>
    
	<dependencies>
		<dependency>
	        <groupId>org.bouncycastle</groupId>
	        <artifactId>bcprov-jdk16</artifactId>
	        <version>1.46</version>
	        <scope>system</scope>
	        <systemPath>${project.basedir}/src/main/resources/jar/bcprov-jdk16-1.46.jar</systemPath>
	    </dependency>
    </dependencies>
	<build>
		<plugins>
			<plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <includeSystemScope>true</includeSystemScope>
                </configuration>
            </plugin>
            <!-- 下面是为了将本地jar包打入WEB-INF/lib下而增加的配置-->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-war-plugin</artifactId>
                <version>3.2.2</version>
                <configuration>
                    <webResources>
                        <resource>
                        	<!-- 指向的是包含你所有要用jar包的目录 -->
                            <directory>${project.basedir}/src/main/resources/jar</directory> 
                            <!-- 编译后要把这些jar包复制到的位置 -->
                            <targetPath>WEB-INF/lib</targetPath>  
                        </resource>
                    </webResources>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project> 

  

配置完后,再次运行package命令,发现本地的jar包完美的打进了WEB-INF/lib下,到此问题解决了!

另外还有个需要注意的地方,由于使用的是maven-war-plugin,因此打jar包的时候不适用哦~

 

 

 

==================================================================================

 

 

 

点击运行控制台会打印打包的过程信息,主要看最后是不是显示成功。如果成功,说明前面步骤没问题。

如果失败了,那么请再次检查上面的步骤以及注意的事项。

 

 

 

2、如下图打开target,打好的包就在该目录下,名称为项目名-0.0.1-SNAPSHOT.war,首先把名字改一下,改成ROOT.war,

改名字为ROOT主要是不用打项目名,在服务器上测试直接可以localhost加端口号加你的项目登录路径就能打开系统页面。

我们祭出ctrl+c,ctrl+v大法把该war包放到桌面,再移动到腾讯云服务器的tomcat中去。

 

 

 

包已经打好,那么我们接下来到服务器的tomcat中操作

  首先一定要确保tomcat可以正常启动

1、将war包移动到腾讯云服务器tomcat目录下的webapps中,不需要解压,不需要任何操作。

      如果webapps目录中有ROOT文件夹,删除即可。

2、启动tomcat

现在解释为什么一定要tomcat9.0版本,因为我们的war包中默认打的tomcat的lib包为9.0版本

如图所示:如果我们尝试放在tomcat别的版本上,启动tomcat控制台就会报各种异常。

 

 

 

 

按道理是可以改版本的,但是由于太懒,所以没去找解决方案。。。

最后跑完看一下控制台,看看是否有报错,然后在服务器的本地上进行测试吧。

如果改名字为ROOT.war,在服务器上测试直接可以localhost+端口号+你的项目登录路径就能打开系统页面。

如:localhost:8080/sys/login

如果没改名字,还是原来项目名.war,在服务器上测试直接可以localhost+端口号+你的项目名+登录路径就能打开系统页面。

如:localhost:8080/项目名/sys/login

 

如果你们服务器上测试也没问题了,那么就要公网测试了,这个就不多说了,服务器能跑起来公网的问题其实注意两点就行

1、腾讯云注意安全组开放端口,这里建议开放80端口的那个选项,然后把该服务器添加到安全组中,之后把tomcat的端口改成80。

2、安全组开放了之后有可能还不能公网访问,那么就是防火墙的问题了,把防火墙关闭即可。

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

  

 

以上是关于IDEA Spring boot Maven打包发布的主要内容,如果未能解决你的问题,请参考以下文章

记录解决maven 打包spring boot 项目生成的jar包少8小时

IDEA快速部署Spring Boot 项目到Docker

Spring Boot 应用的打包和发布

Spring boot如何引入本地jar包?

Spring Boot之输出hello

Idea用maven给springboot打jar包