Maven构建插件执行顺序异常：本地依赖自动安装在package阶段失效

Maven执行任何生命周期命令时，都会先完成依赖解析——这是所有生命周期阶段（包括validate）之前就触发的核心操作。

当你执行mvn package时，Maven会先尝试解析pom.xml里的所有依赖：此时你的本地Jar还没被安装到.m2仓库，它就会去中央仓库查找，找不到自然报错。

而单独执行mvn validate时，这个命令不需要依赖编译/打包资源，Maven不会触发完整的依赖解析，所以插件能顺利执行并把Jar安装到本地仓库；之后再执行mvn compile时，依赖解析阶段能从本地仓库找到已安装的Jar，因此成功。如果直接执行mvn clean package（无前置validate），就会重现报错——因为依赖解析发生在validate阶段之前。

方法一：使用System Scope直接引入本地Jar（简单高效） #

不需要将Jar安装到本地仓库，直接在pom.xml里配置system依赖，同时让打包插件包含该依赖：

1. 在项目根目录创建lib文件夹，放入你的本地Jar。
2. 配置依赖：

<dependency>
    <groupId>自定义groupId</groupId>
    <artifactId>自定义artifactId</artifactId>
    <version>自定义版本号</version>
    <scope>system</scope>
    <systemPath>${project.basedir}/lib/你的Jar文件名.jar</systemPath>
</dependency>

3. 配置打包插件（以生成fat jar的maven-shade-plugin为例）：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.2.4</version>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>
            <configuration>
                <!-- 强制包含system scope的依赖 -->
                <includeSystemScope>true</includeSystemScope>
            </configuration>
        </execution>
    </executions>
</plugin>

这种方式下Maven不会去中央仓库查找该依赖，直接使用本地文件，打包时也能将其纳入fat jar。

方法二：让install-file强制在依赖解析前执行（适合坚持安装到仓库的场景） #

由于Maven的依赖解析在生命周期之前，常规阶段绑定无法满足需求，可通过以下方式实现自动化：

1. 在pom.xml中配置maven-install-plugin，不绑定到任何阶段：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-install-plugin</artifactId>
    <version>3.1.0</version>
    <executions>
        <execution>
            <id>install-local-jar</id>
            <phase>none</phase>
            <goals>
                <goal>install-file</goal>
            </goals>
            <configuration>
                <file>${project.basedir}/lib/你的Jar文件名.jar</file>
                <groupId>自定义groupId</groupId>
                <artifactId>自定义artifactId</artifactId>
                <version>自定义版本号</version>
                <packaging>jar</packaging>
            </configuration>
        </execution>
    </executions>
</plugin>

2. 使用Maven的--pre-goal参数，让install-file在任何命令前执行：

mvn --pre-goal install:install-file@install-local-jar package

如果不想每次手动输入参数，可在项目根目录创建脚本（如build.sh）：

#!/bin/bash
mvn --pre-goal install:install-file@install-local-jar "$@"

之后执行./build.sh package即可自动前置install步骤。

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