питон либ луна питонлиб солнце progerlib цветок

更换主题

登录 注册

Maven与本地JAR：5个致命错误及其解决方案

面向初学者的在线Python训练器

轻松学习Python，无需理论负担。在浏览器中直接解决带自动检查的实践任务，无需安装任何东西。

开始课程

为什么“直接把JAR复制到文件夹”行不通？



每一位曾与Maven打过交道的Java开发者，迟早都会遇到这样的困境：“我需要引入一个在Maven Central上找不到的旧库。该怎么办？”。你去搜索，找到一个在Stack Overflow上有数千次浏览的问题，尝试了第一个建议——然后得到了ClassNotFoundException或Missing artifact错误。



熟悉吗？在本文中，我们将剖析在Maven项目中添加本地JAR文件时的常见错误，更重要的是，如何避免它们。你不仅会学到理论知识，还会看到可以直接应用于你的Java项目中的可运行代码。



错误#1：使用System scope但未指定systemPath



新手最容易掉入的陷阱——添加了带有<scope>system</scope>的依赖项，却忘记指定<systemPath>。Maven会诚实地尝试找到JAR，但不知道它在哪里。



错误表现

[ERROR] Failed to execute goal on project my-app: Could not resolve dependencies for project com.example:my-app:jar:1.0: The following artifacts could not be resolved: com.example:my-custom-lib:jar:1.0 (absent)


错误代码

<dependency>    <groupId>com.example</groupId>    <artifactId>my-custom-lib</artifactId>    <version>1.0</version>    <scope>system</scope>    <!-- systemPath缺失！ --></dependency>


正确解决方案

始终通过<systemPath>指定JAR文件的完整路径。建议使用相对于项目根目录的路径，以避免绑定到特定开发机器。



<dependency>    <groupId>com.example</groupId>    <artifactId>my-custom-lib</artifactId>    <version>1.0</version>    <scope>system</scope>    <systemPath>${project.basedir}/libs/my-custom-lib-1.0.jar</systemPath></dependency>


重要提示： JAR文件必须位于项目内的libs/文件夹中。如果还没有，请创建它。



错误#2：在多模块项目中忘记使用install-file



假设你通过system scope添加了本地JAR，并且在本地一切正常。但是当你尝试在CI服务器（Jenkins、GitLab CI）上构建项目时——构建失败了。为什么？因为system scope不会传递，也不会进入Maven本地仓库。



正确方法：将JAR安装到本地仓库

使用mvn install:install-file命令。这会将你的JAR添加到~/.m2/repository中，使其对所有项目模块和CI构建都可用。



mvn install:install-file \   -Dfile=libs/my-custom-lib-1.0.jar \   -DgroupId=com.example \   -DartifactId=my-custom-lib \   -Dversion=1.0 \   -Dpackaging=jar \   -DgeneratePom=true


之后，在pom.xml中就可以指定普通的依赖项，无需systemPath：



<dependency>    <groupId>com.example</groupId>    <artifactId>my-custom-lib</artifactId>    <version>1.0</version></dependency>


错误#3：在仓库中使用file:// URL



一些开发者试图通过<repository>添加本地文件夹作为仓库，并使用file:// URL来“欺骗”Maven。从技术上讲，这可行，但会带来一堆问题：