如何将无版本号的Maven外部JAR导入本地仓库并解决依赖问题

问题背景 #

我正在将一个基于Ant的Eclipse项目迁移到Maven，已完成通用依赖的pom.xml配置，现在需要引入一批外部自定义JAR包（多数无源码）。这些JAR存在依赖关系，例如foobar.jar和依赖它的foobarOne.jar。

导入本地JAR到Maven仓库时，Maven会自动将JAR重命名为foobar-1.0.jar这种带版本号的格式，导致JAR间的依赖（比如动态加载时依赖原文件名）失效，想知道如何解决这个问题？

批量导入本地JAR的Python脚本 #

为了批量导入这些JAR到本地仓库，我编写了以下Python脚本（开发前执行）：

import os
import subprocess

def install_jars(directory):
    # 遍历目录查找所有JAR文件
    for root, dirs, files in os.walk(directory):
        for file in files:
            if file.endswith(".jar"):
                file_path = os.path.join(root, file)
                # 提取不带扩展名的文件名
                filename, extension = os.path.splitext(file)
                # 执行Maven导入命令（固定版本号，避免默认值）
                install_command = f"mvn install:install-file -Dfile={file_path} -DgroupId=local -DartifactId={filename} -Dversion=0.0.1 -Dpackaging=jar"
                subprocess.run(install_command, shell=True, check=True)

if __name__ == "__main__":
    # 指定JAR所在目录（跨平台写法）
    jar_directory = os.path.join(os.path.dirname(os.path.realpath(__file__)), "dependencies")
    install_jars(jar_directory)

注：脚本中固定版本号为0.0.1，避免Maven自动使用默认的1.0；添加check=True确保命令执行失败时抛出异常，方便排查问题。

pom.xml中的依赖引用 #

导入后在pom.xml中添加如下依赖配置：

<dependency>
    <groupId>local</groupId>
    <artifactId>foobar</artifactId>
    <version>0.0.1</version>
</dependency>
<dependency>
    <groupId>local</groupId>
    <artifactId>foobarOne</artifactId>
    <version>0.0.1</version>
</dependency>

解决方案 #

Maven的仓库结构规范要求必须包含版本号，无法直接跳过版本号设置或强制保留原JAR文件名。针对JAR间依赖失效的问题，可采用以下两种方案：

方案一：用Maven依赖插件复制并重命名JAR #

通过maven-dependency-plugin将依赖的JAR复制到项目输出目录时，重命名为原文件名，确保依赖的JAR能找到对应文件。在pom.xml的<build>节点下添加如下插件配置：

<plugins>
    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-dependency-plugin</artifactId>
        <version>3.6.0</version>
        <executions>
            <execution>
                <id>copy-local-jars</id>
                <phase>process-resources</phase>
                <goals>
                    <goal>copy</goal>
                </goals>
                <configuration>
                    <artifactItems>
                        <!-- 逐个配置需要重命名的JAR -->
                        <artifactItem>
                            <groupId>local</groupId>
                            <artifactId>foobar</artifactId>
                            <version>0.0.1</version>
                            <outputDirectory>${project.build.directory}/lib</outputDirectory>
                            <destFileName>foobar.jar</destFileName>
                        </artifactItem>
                        <artifactItem>
                            <groupId>local</groupId>
                            <artifactId>foobarOne</artifactId>
                            <version>0.0.1</version>
                            <outputDirectory>${project.build.directory}/lib</outputDirectory>
                            <destFileName>foobarOne.jar</destFileName>
                        </artifactItem>
                    </artifactItems>
                </configuration>
            </execution>
        </executions>
    </plugin>
</plugins>

执行mvn process-resources后，JAR会被复制到target/lib目录并恢复原文件名，后续项目运行时指向该目录即可。

方案二：使用system依赖（不推荐） #

直接引用本地JAR文件，不导入Maven仓库，可保留原文件名。但该方式移植性差，其他开发者需要手动将JAR放置到指定路径：

<dependency>
    <groupId>local</groupId>
    <artifactId>foobar</artifactId>
    <version>0.0.1</version>
    <scope>system</scope>
    <systemPath>${project.basedir}/dependencies/foobar.jar</systemPath>
</dependency>

内容的提问来源于stack exchange，提问作者cruz190