关于IDEA使用Maven工具打包带有本地依赖包的项目 在部署时 仍然找不到本地依赖包中某个类，发生ClassNotFoundException的异常

Posted 2022-11-27 新来的大狮

关于IDEA使用Maven工具打包带有本地依赖包的项目 在部署时 仍然找不到本地依赖包中某个类，发生ClassNotFoundException的异常

• 参考文章
• 1 运行时环境介绍（非部署环境）
• • 1.1 开发环境
  • 1.2 Maven的pom文件关于Maven工具的环境
• 2 问题实质与解决方案
• • 2.1 问题描述
  • • • 2.1.1 本地依赖包的实际路径
      • 2.1.2 pom文件中已声明的运行时依赖本地jar包的代码
      • 2.1.3 maven运行时打包已经完美成功
      • 2.1.4 将生成的jar包放在目标环境中部署时（一个linux环境）发生了ClassNotFoundException的异常
  • 2.2 解决方案
  • 2.3 原因分析和注意事项
  • • • 2.3.1 原因
      • 2.3.2 注意事项

参考文章

一个小虾米 - Maven引入本地jar包，并将本地jar包打包到最终得jar/war包中

1 运行时环境介绍（非部署环境）

1.1 开发环境

IDEA-2018.3

1.2 Maven的pom文件关于Maven工具的环境

	<parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.4.2</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    
	<build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

2 问题实质与解决方案

2.1 问题描述

在使用IDEA的Maven工具已经在该Maven项目的pom文件中对Maven声明了需要使用的本地依赖包，该项目运行时没有问题，打包也成功。但是将生成的jar包部署到 实际环境 后却出现了外部jar包中某个类 ClassNotFoundException的异常。

2.1.1 本地依赖包的实际路径

（该项目的lib文件夹下的两个本地依赖包）

2.1.2 pom文件中已声明的运行时依赖本地jar包的代码

		<!--添加的本地的工具jar包依赖-->
        <dependency>
            <groupId>com.hhu.wlx</groupId>
            <artifactId>wmsupport</artifactId>
            <version>1.0-SNAPSHOT</version>
            <scope>system</scope>
            <systemPath>$project.basedir/lib/wmsupport-1.0-SNAPSHOT.jar</systemPath>
        </dependency>

        <!--添加的本地的外部netCDF文件处理jar包依赖-->
        <dependency>
            <groupId>netcdf</groupId>
            <artifactId>ucar</artifactId>
            <version>4.6.15</version>
            <scope>system</scope>
            <systemPath>$project.basedir/lib/netcdfAll-4.6.15.jar</systemPath>
        </dependency>

2.1.3 maven运行时打包已经完美成功

待部署的项目（cwl_d）已经完美打包成功

2.1.4 将生成的jar包放在目标环境中部署时（一个linux环境）发生了ClassNotFoundException的异常

本地依赖包（wmsupport包）中的自定义的类（ModelReceiveNcProcessor类）未找到。

ModelReceiveNcProcessor类属于本地依赖包wmsupport包中的一个类

2.2 解决方案

在pom文件中声明，使jar包在build时，不能让Maven项目自动过滤掉外部资源（本地jar包）

主要增加< resources >标签块的内容

	<build>
	
        <!--打包时,将本地jar打包到jar/war文件中-->
        <resources>
            <resource>
                <!--本地jar得目录-->
                <directory>$project.basedir/lib</directory>
                <!--打包时，目标jar存放位置-->
                <targetPath>BOOT-INF/lib/</targetPath>
                <includes>
                    <include>**/*.jar</include>
                </includes>
            </resource>
            <!--第二种加载指定文件-->
            <resource>
                <directory>src/main/resources</directory>
                <includes>
                    <include>**/*.txt</include>
                    <include>**/*.yml</include>
                </includes>
                <filtering>false</filtering>
            </resource>
        </resources>
        
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

声明构建jar包时需要添加的本地依赖后生成的jar包 大小对比

声明构建jar包时需要添加的本地依赖后生成的jar包 其中包含的lib库对比

2.3 原因分析和注意事项

2.3.1 原因

由于Maven工具在打包时会出现自动过滤掉静态资源的情况，需要将引入的本地jar包在jar包构建时声明 该jar包需要引入（不能过滤）。

2.3.2 注意事项

一旦指定了jar包构建时需要引入的目标资源，所有其他的静态资源也需要一同引入（如resources文件夹下的application.yml静态配置文件）
具体方法：pom文件中再次指定其他在jar包构建时需要引入的静态资源

已经集成在解决方法2.2的代码中

实际使用的具体代码如下：

			<!--第二种加载指定文件-->
            <resource>
                <directory>src/main/resources</directory>
                <includes>
                    <include>**/*.txt</include>
                    <include>**/*.yml</include>
                </includes>
                <filtering>false</filtering>
            </resource>