【问题解决】maven外部第三方jar引入问题

项目在使用Aspose-Words进行word转pdf时,遇到阿里云Maven仓库缺少该依赖的问题。解决方案包括:1) 使用maven的install命令手动将jar包安装到本地仓库;2) 在pom.xml中添加systemPath引用,并配置资源路径,确保在Linux环境也能正常运行。同时,对于Linux环境,还需配置build部分以解决jar包被打入BOOT-INF问题。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

报错信息:

Failed to execute goal on project jeecg-boot-base-core: Could not resolve dependencies for project xxx: Could not find artifact com.aspose:aspose-words:jar:15.8.0 in aliyun (http://maven.aliyun.com/nexus/content/groups/public)

问题描述:项目中有个word文档转pdf的需求,作者放弃了jacob选用了aspose-words类库,这个类库既支持linux环境下又支持windows环境下word转pdf。但是,阿里云maven仓库没有这个包,导致项目打包运行失败。
解决方法:

第一种,下载aspose-words-15.8.0-jdk16.jar包后,通过maven命令手动安装到本地maven仓库

mvn install:install-file -DgroupId=com.aspose -DartifactId=aspose-words -Dversion=15.8.0 -Dpackaging=jar -Dfile=aspose-words-15.8.0-jdk16.jar
 
-DgroupId:pom.xml中groupId
-DartifactId:pom.xml中artifactId
-Dversion:pom.xml中0.0.1-SNAPSHOT
-Dpackaging:jar或war,包的后缀名
-Dfile:包的本地真实地址,如果像作者这么写,需要在jar所在的目录下执行该命令,否则会找不到

pom信息参考

<dependency>
	<groupId>com.aspose</groupId>
	<artifactId>aspose-words</artifactId>
	<version>15.8.0</version>
</dependency>

第二种:将下载的jar包放在项目路径下,在pom中直接引用如果linux环境下上面方式还是找不到包则使用这种方式。pom引用方式参考:

 <dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-words</artifactId>
    <version>15.8.0</version>
    <scope>system</scope>
    <systemPath>${project.basedir}/src/main/resources/lib/aspose-words-15.8.0-jdk16.jar</systemPath>
</dependency>

systemPath:指定了引用jar包所在的位置,${project.basedir}指定是在当前项目下。

配置完之后,可以实现idea中本地导包,但是在linux环境下还是有问题,需要在pom中进一步配置信息完整的配置参考如下:

  <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <!--微服务模式下修改为true,跳过此打包插件,否则微服务模块无法引用-->
                    <skip>false</skip>
                </configuration>
            </plugin>
        </plugins>
      	<!--配置resource信息,解决linux环境下,依赖jar包打入项目jar的BOOT-INF位置问题 --> 
        <resources>
            <resource>
                <directory>src/main/java</directory>
                <includes>
                    <include>**/*</include>
                </includes>
            </resource>
            <resource>
                <directory>src/main/resources</directory>
                <includes>
                    <include>**/*</include>
                </includes>
            </resource>
            <resource>
                <directory>src/main/resources</directory>
                <targetPath>BOOT-INF/</targetPath>
                <includes>
                    <include>/lib/*.jar</include>
                </includes>
            </resource>
        </resources>
    </build>

以上是以解决aspose-words-15.8.0-jdk16.jar找不到问题为例,此同类型问题均可尝试以上两种解决方案。参考文章1,这篇文章解释一些原因,但是对于解决问题提出的方案作者持保留态度,作者根据这篇文章的解决方案是没解决掉问题。

### 如何在 Java Maven 项目中添加和配置第三方 JAR 文件 #### 方法一:通过 POM.XML 添加依赖项 如果目标第三方 JAR 已经存在于公共 Maven 仓库或者私有远程仓库,则可以直接在 `pom.xml` 中声明其依赖关系。例如: ```xml <dependency> <groupId>com.wst</groupId> <artifactId>wst-hsm-api</artifactId> <version>1.7.3</version> </dependency> ``` 上述代码片段展示了如何将名为 `wst-hsm-api` 的 JAR 包作为项目的依赖引入[^1]。 --- #### 方法二:安装本地 JAR 到本地 Maven 仓库 当所需的第三方 JAR 不在任何可用的 Maven 远程仓库中时,可以将其手动安装至本地 Maven 仓库。执行以下命令即可完成操作: ```bash mvn install:install-file -Dfile=<path-to-file> -DgroupId=<group-id> \ -DartifactId=<artifact-id> -Dversion=<version> -Dpackaging=jar ``` 其中 `<path-to-file>` 是实际 JAR 文件路径;其他参数如 `groupId`, `artifactId`, 和 `version` 都需自行指定。完成后,在 `pom.xml` 中按照常规方式引用此 JAR 即可。 --- #### 方法三:利用 system 范围直接引用本地 JAR 另一种方法是在项目根目录下创建一个专门用于存储这些外部库的新文件夹(比如命名为 libs),并将所需 JAR 放置于此处。接着修改 `pom.xml` 来指明这个位置以及对应的坐标信息: ```xml <dependency> <groupId>com.hikvision.building.cloud</groupId> <artifactId>consumer</artifactId> <version>1.1.1</version> <scope>system</scope> <systemPath>${project.basedir}/libs/consumer-1.1.1.jar</systemPath> </dependency> ``` 这种方法适用于那些仅限于当前工程使用的特殊类库情况[^3]。 --- #### 方法四:调整 IDEA 设置以便支持第三方 jar 打包 对于某些特定需求场景下的开发环境(例如 IntelliJ IDEA),还需要进一步设置才能确保最终产物能够正确包含所有必要的组件。这通常涉及到了解并合理运用构建工具的相关插件功能。下面是一个典型例子展示怎样借助 Spring Boot 插件实现这一点: ```xml <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> <!--maven 编译的时候能将第三方包编入 --> <configuration> <includeSystemScope>true</includeSystemScope> </configuration> </plugin> ``` 这里的关键在于设置了 `<includeSystemScope>` 属性为 true ,从而允许系统范围内的依赖被纳入打包过程之中[^2]。 --- ### 总结 以上介绍了四种不同的途径来解决 “如何向基于 Maven 构建体系之上的 Java 应用程序加入额外的非标准库”的问题。每种方案都有各自适用场合及其优缺点考量因素存在。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

小猿架构

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值