详解IDEA使用Maven项目不能加入本地Jar包的解决方法

下面是详解“详解IDEA使用Maven项目不能加入本地Jar包的解决方法”的完整攻略。

症状

在使用IDEA进行Maven项目开发时，可能会出现无法加入本地Jar包的情况，表现为项目运行时无法找到相应的类或方法。

原因

主要原因是Maven的本地仓库只能管理已经通过Maven构建过的代码库，而Maven不能直接管理本地Jar包。因此，如果想要使用本地Jar包，需要手动将其添加到Maven仓库中。

解决方法

1.命令行添加本地Jar包到Maven仓库

将本地jar包加入到Maven仓库可以使用以下命令：

mvn install:install-file -DgroupId=com.example -DartifactId=some-artifact -Dversion=1.0 -Dfile=some-artifact.jar -Dpackaging=jar

其中，-DgroupId表示这个Jar包的Group Id，-DartifactId表示Artifact Id，-Dversion表示Version，-Dfile表示本地Jar包的路径，-Dpackaging表示打的包的类型。

执行完后，在本地Maven仓库就创建了一个相应的Jar包，可以在新项目中引入该依赖。

2.使用Maven插件手动将本地Jar包添加到Maven仓库

可以使用Maven的官方插件“maven-install-plugin”手动将本地的Jar包添加到Maven仓库中。在pom.xml文件中加入以下的配置：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-install-plugin</artifactId>
            <version>2.3.1</version>
            <executions>
                <execution>
                    <id>install-external</id>
                    <phase>install</phase>
                    <configuration>
                        <file>${path-to-jar}</file>
                        <groupId>${group-id}</groupId>
                        <artifactId>${artifact-id}</artifactId>
                        <version>${version}</version>
                        <packaging>jar</packaging>
                    </configuration>
                    <goals>
                        <goal>install-file</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

其中，${path-to-jar}表示本地Jar包路径，${group-id}、${artifact-id}和${version}则表示该依赖项的GroupId、ArtifactId和Version。

加入配置之后，执行“mvn install”命令即可将本地的Jar包添加到Maven仓库。

示例

假设有一个名为“example”的本地Jar包，路径为“/Users/username/my-lib/example.jar”，需要在Maven项目中引用。可以按如下方式进行添加：

1.命令行

首先，开启一个终端，进入到项目目录下，然后执行以下命令：

mvn install:install-file -DgroupId=com.example -DartifactId=example -Dversion=1.0 -Dfile=/Users/username/my-lib/example.jar -Dpackaging=jar

其中，-DgroupId设置为“com.example”，-DartifactId设置为“example”，-Dversion设置为“1.0”，-Dfile设置为“/Users/username/my-lib/example.jar”，-Dpackaging设置为“jar”。

执行命令后，终端应该会输出如下信息：

[INFO] Scanning for projects...
[INFO]
[INFO] ---------------------< com.example:example >---------------------
[INFO] Building example 1.0
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] --- maven-install-plugin:2.3.1:install-file (default-cli) @ example ---
[INFO] Installing /Users/username/my-lib/example.jar to /Users/username/.m2/repository/com/example/example/1.0/example-1.0.jar
[INFO] Installing /var/folders/l0/xyz/T/mvninstall8755138140018213794.pom to /Users/username/.m2/repository/com/example/example/1.0/example-1.0.pom
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  1.064 s
[INFO] Finished at: 2020-04-22T19:14:18+08:00
[INFO] ------------------------------------------------------------------------

这就说明添加成功了。

2.Maven插件

在项目目录下的pom.xml中，加入以下配置：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-install-plugin</artifactId>
            <version>2.3.1</version>
            <executions>
                <execution>
                    <id>install-external</id>
                    <phase>install</phase>
                    <configuration>
                        <file>/Users/username/my-lib/example.jar</file>
                        <groupId>com.example</groupId>
                        <artifactId>example</artifactId>
                        <version>1.0</version>
                        <packaging>jar</packaging>
                    </configuration>
                    <goals>
                        <goal>install-file</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

然后在终端中进入项目目录下，执行以下命令：

mvn install

执行完成后，刷新Maven依赖即可。