Maven：在package阶段安装本地依赖的问题

问题场景 #

想要在构建Jar包前，通过在主项目的pom.xml中添加Ant运行任务来安装本地依赖，配置如下：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-antrun-plugin</artifactId>

    <executions>
        <execution>
            <id>Install Local Dependencies</id>
            <goals>
                <goal>run</goal>
            </goals>
            <phase>validate</phase>
            <configuration>
                <target>
                    <echo message="Installing local lib" />
                    <exec executable="/usr/local/bin/mvn">
                        <arg value="-f ${lib.dir}/pom.xml clean install " />
                    </exec>
                </target>
            </configuration>
        </execution>
    </executions>
    <dependencies>
        <dependency>
            <groupId>org.apache.ant</groupId>
            <artifactId>ant-jsch</artifactId>
            <version>1.9.6</version>
        </dependency>
    </dependencies>
</plugin>

但任务执行失败，核心原因是Ant的exec任务默认从当前项目目录启动mvn命令，导致外部POM的路径解析出现异常。

解决方法 #

方法1：修改Ant exec任务指定工作目录 #

在Ant的exec标签中添加dir属性，指定外部POM所在的目录，让mvn命令直接在目标目录下执行，避免路径问题：

<exec executable="/usr/local/bin/mvn" dir="${lib.dir}">
    <arg value="clean install" />
</exec>

如果需要指定特定的POM文件名，也可以拆分参数避免解析错误：

<exec executable="/usr/local/bin/mvn" dir="${lib.dir}">
    <arg value="-f" />
    <arg value="custom-pom.xml" />
    <arg value="clean" />
    <arg value="install" />
</exec>

方法2：使用Maven Invoker插件替代Antrun #

maven-invoker-plugin是Maven官方提供的、专门用于在构建中调用其他Maven项目的插件，比Antrun更贴合Maven生态，配置更简洁稳定：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-invoker-plugin</artifactId>
    <version>3.5.0</version>
    <executions>
        <execution>
            <id>install-local-deps</id>
            <goals>
                <goal>install</goal>
            </goals>
            <phase>validate</phase>
            <configuration>
                <pomFile>${lib.dir}/pom.xml</pomFile>
                <goals>
                    <goal>clean</goal>
                    <goal>install</goal>
                </goals>
            </configuration>
        </execution>
    </executions>
</plugin>

该插件会自动处理工作目录、Maven命令执行等细节，无需手动维护路径参数。

方法3：转为Maven多模块项目（推荐） #

如果本地依赖是你维护的代码，最规范的方式是将主项目和依赖项目合并为Maven多模块，在父POM中声明模块顺序：

<modules>
    <module>../path/to/local-dependency</module>
    <module>.</module>
</modules>

Maven会自动按照模块顺序构建，先完成依赖模块的install，再构建主项目，完全不需要额外任务配置，是Maven官方推荐的最佳实践。

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