关于maven3:聊聊springboot项目引用第三平台私有jar踩到的坑

前言

最近和敌人闲聊，他说他遇到一个问题，他援用了第三方公司公有 API 包，他在本地我的项目启动没问题，打包运行却找不到这个 API 包，于是我就问他怎么援用这个 jar。

他工程项目第三 jar 寄存的地位相似如下

在 pom 做如下援用

   <dependency>
            <groupId>org.example</groupId>
            <artifactId>demo-api</artifactId>
            <version>1.0-SNAPSHOT</version>
            <scope>system</scope>
            <systemPath>${project.basedir}/lib/demo-api.jar</systemPath>
        </dependency>

pom 打包插件用 springboot 自带的插件

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <executions>
                    <execution>
                        <goals>
                            <goal>repackage</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>

看到这个插件，大略就晓得问题所在了，springboot 默认的打包插件是不会把 systemscope 的 jar 打进 springboot 我的项目的 BOOT-INF/lib/。

注： springboot 我的项目默认会援用 BOOT-INF/lib/ 外面的 jar

于是我就跟敌人说，不要用 systemscope 了，间接搭建 maven 私仓，而后把第三方 jar 上传到私仓中，pom 做如下援用

   <dependency>
            <groupId>org.example</groupId>
            <artifactId>demo-api</artifactId>
            <version>1.0-SNAPSHOT</version>
        </dependency>

敌人给回复是公司没有私仓，我一脸懵逼，我就问他应该不至于吧，再次确认，失去他同样的回复后。后边就提供了下边的几种计划，让他参考抉择

springboot 如何援用没有公布到私仓的第三 jar

整体思路：因为 springboot 提供的打包插件，默认是会把位于 BOOT-INF/lib/ 外面的 jar 编译成 class 文件而后供我的项目援用。因而咱们只需确保 BOOT-INF/lib/ 外面含有咱们要援用的第三方 jar 即可

计划一：pom 指定 jar 范畴为 system+springboot 插件退出 includeSystemScope 标签的属性为 true

示例：

   <dependency>
            <groupId>org.example</groupId>
            <artifactId>demo-api</artifactId>
            <version>1.0-SNAPSHOT</version>
            <scope>system</scope>
            <systemPath>${project.basedir}/lib/demo-api.jar</systemPath>
        </dependency>

 <build>

        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <includeSystemScope>true</includeSystemScope>
                </configuration>
                <executions>
                    <execution>
                        <goals>
                            <goal>repackage</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>

计划二：pom 指定 jar 范畴为 system+resources 标签引入要蕴含的 jar

   <dependency>
            <groupId>org.example</groupId>
            <artifactId>demo-api</artifactId>
            <version>1.0-SNAPSHOT</version>
            <scope>system</scope>
            <systemPath>${project.basedir}/lib/demo-api.jar</systemPath>
        </dependency>

 <build>
        <resources>
            <resource>
                <directory>${project.basedir}/lib</directory>
                <targetPath>BOOT-INF/lib/</targetPath>
                <includes>
                    <include>**/*.jar</include>
                </includes>
            </resource>
        </resources>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <executions>
                    <execution>
                        <goals>
                            <goal>repackage</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>

计划三：间接将第三方 jar 打进要公布的本地仓库

上图是 maven 官网的仓库流程图，其实对 maven 比拟相熟的敌人应该会晓得，maven 会先从本地仓库找 jar，本地仓库找不到 jar，就会再从私仓（如果有搭建私仓）外面找，私仓没有再从地方仓库找，而后找到的 jar 再寄存到本地仓库。

因而咱们执行如下命令就能够将第三方 jar 间接打进本地仓库

mvn install:install-file -DgroupId=org.example -DartifactId=demo-api -Dversion=1.0-SNAPSHOT -Dfile=F:\boot-thirdparty\lib\demo-api.jar -Dpackaging=jar

我的项目的 pom 间接向如下引入第三方 jar 即可

   <dependency>
            <groupId>org.example</groupId>
            <artifactId>demo-api</artifactId>
            <version>1.0-SNAPSHOT</version>
        </dependency>

计划四：搭建 maven 私仓，将第三方 jar 上传到 maven 私仓

注： 搭建私仓不在本文阐述范畴，就讲下如何将第三方 jar 上传到私仓

a、 先在 maven 的 settings.xml 的 servers 标签配置如下内容

<server>
        <id>nexus</id>
        <username>admin</username>
        <password>admin123</password>
    </server>

b、 执行发布命令行，如下

mvn deploy:deploy-file -DgroupId=org.example -DartifactId=demo-api -Dversion=1.0-SNAPSHOT -Dpackaging=jar -Dfile=F:\boot-thirdparty\lib\demo-api.jar -Durl= 你的私仓地址 -DrepositoryId= 和 settings.xml 配置 server 标签 id 统一，如上的 nexus 

或者也能够利用 maven 私仓自带的可视化界面进行上传

总结

下面几种计划，集体是比拟偏向计划三和计划四，因为原本就是用 maven 来治理 jar 了，在我的项目中还要额定把 jar 引进来，而后再批改插件，看着就感觉有点变扭