maven 在构建开始前就解析并验证所有依赖，因此无法在 validate 阶段通过 maven-install-plugin 安装本地 jar 后再供 compile 或 package 使用——依赖解析发生在生命周期执行之前。
maven 在构建开始前就解析并验证所有依赖，因此无法在 validate 阶段通过 maven-install-plugin 安装本地 jar 后再供 compile 或 package 使用——依赖解析发生在生命周期执行之前。
在 Maven 构建过程中，依赖解析（Dependency Resolution）是独立于生命周期阶段的前置步骤，它在任何 phase（如 validate、compile、package）实际执行前就已完成。这意味着：
- 当你运行 mvn package 时，Maven 首先读取 pom.xml，解析
，并尝试从本地仓库（.m2/repository）和配置的远程仓库（如 Maven Central）定位每个依赖； - 此时若某依赖尚未存在于本地仓库，且未配置可访问的远程仓库提供该 artifact，构建将立即失败——甚至不会进入 validate 阶段；
- 因此，即使你在
validate 绑定了 maven-install-plugin:install-file，该插件根本没有机会执行，因为构建已在依赖解析阶段中止。
✅ 正确做法：将依赖安装作为构建前的预处理步骤，而非构建内部环节。推荐以下两种可靠方案：
方案一：使用 mvn install:install-file 独立命令（推荐）
在执行 mvn package 前，显式安装本地 JAR：
mvn install:install-file \ -Dfile=/path/to/your/local-lib.jar \ -DgroupId=com.example \ -DartifactId=local-lib \ -Dversion=1.0.0 \ -Dpackaging=jar
随后在 pom.xml 中正常声明该依赖：
<dependency><groupid>com.example</groupid><artifactid>local-lib</artifactid><version>1.0.0</version></dependency>
再运行 mvn package 即可成功。
方案二：使用 maven-dependency-plugin 解压并引用（适用于临时场景）
若需完全避免修改本地仓库，可将 JAR 放入项目目录（如 lib/local-lib.jar），并通过 dependency:copy 复制到 target/lib/，再配合 maven-jar-plugin 或 spring-boot-maven-plugin 的 includeSystemScope=true（慎用）引入——但此方式不适用于标准 maven-shade-plugin 构建 fat jar，因系统范围依赖需显式启用支持。
⚠️ 注意事项：
- system 范围依赖（
system ）已被 Maven 3.9+ 强烈弃用，且不参与传递性解析，不应在生产项目中使用； - 自动化脚本（如 CI 流水线）中，应将 install:install-file 作为独立 step 放在 mvn package 之前；
- 永远不要依赖“在生命周期中动态安装依赖”的设计——它违背 Maven 的不可变依赖模型。
总结：Maven 的依赖解析是构建启动时的原子操作，不可延迟或覆盖。确保所有编译/打包依赖在 mvn 命令执行前已就位，是稳定构建的前提。
