systempath在maven打包时失效，因其依赖不参与构建生命周期，仅本地compile阶段生效，导致package/install时类找不到；应改用mvn install:install-file安装到本地仓库或部署至私有仓库。
为什么 systemPath 在 Maven 打包时会失效
因为 systemPath 依赖默认不参与构建生命周期，mvn package 或 mvn install 时不会将其加入 classpath，导致编译通过但运行时报 NoClassDefFoundError 或 ClassNotFoundException。它只在本地 mvn compile 阶段生效，且无法被其他模块或 CI 环境复用。
常见错误现象：java.lang.NoClassDefFoundError: xxx.YourLocalClass；IDE 显示类存在、打包后却找不到；Jenkins 构建失败并提示 “Missing artifact”。
-
systemPath是 Maven 的“临时绕过机制”，不是正规依赖管理方式 - 它绕过了仓库校验、版本冲突解决、传递性依赖解析等核心能力
- 不同 Maven 版本（尤其 3.9+）对
systemPath的警告或限制更严格，部分插件（如maven-shade-plugin）直接忽略它
用 mvn install:install-file 把 jar 安装进本地仓库
这是最稳妥、兼容性最好的替代方案：把本地 jar 当作普通第三方依赖安装到 ~/.m2/repository/，后续所有生命周期阶段都能识别。
执行命令示例（路径和坐标需按实际替换）：
mvn install:install-file \ -Dfile=/path/to/your-local.jar \ -DgroupId=com.example \ -DartifactId=your-local \ -Dversion=1.0.0 \ -Dpackaging=jar
- 安装后，在
pom.xml中像引用普通依赖一样写：<dependency><groupId>com.example</groupId><artifactId>your-local</artifactId><version>1.0.0</version></dependency></li> <li>确保 <code>groupId
、artifactId、version与安装命令一致，否则依赖解析失败 - 如果 jar 有
MANIFEST.MF里的Class-Path或依赖其他 jar，需手动补全对应依赖项，install-file不自动处理传递依赖
多人协作或 CI 场景下必须用私有仓库（Nexus / Artifactory）
仅靠 mvn install:install-file 只解决单机问题，团队成员或 CI 服务器没有该 jar 就会构建失败——这不是“替代方案”的终点，而是起点。
正确做法是把 jar 推送到团队共用的私有仓库：
- 先配置
settings.xml的<server></server>，绑定仓库账号 - 用
mvn deploy:deploy-file替代install-file，指定-DrepositoryId=your-nexus和-Durl=https://nexus.example.com/repository/maven-releases/ - 所有成员只需配置相同仓库地址，无需手动 install
- 注意：快照版（
-SNAPSHOT）需推送到 snapshot 仓库，且 URL 路径、仓库策略要匹配，否则返回 401 或 405 错误
真不想动仓库？试试 scope=system + systemPath 的补救式写法（仅限应急）
如果你完全无法接触仓库、又必须让 mvn package 成功，可以配合 maven-dependency-plugin 把 systemPath jar 拷贝进 target/lib/，再用 maven-jar-plugin 写入 Class-Path。
关键配置片段：
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-dependency-plugin</artifactId>
<executions>
<execution>
<id>copy-system-deps</id>
<phase>prepare-package</phase>
<goals><goal>copy</goal></goals>
<configuration>
<artifactItems>
<artifactItem>
<groupId>com.example</groupId>
<artifactId>your-local</artifactId>
<version>1.0.0</version>
<outputDirectory>${project.build.directory}/lib</outputDirectory>
</artifactItem>
</artifactItems>
</configuration>
</execution>
</executions>
</plugin>
- 必须同时配置
maven-jar-plugin的archive.manifestEntries.Class-Path，否则 jar 启动时仍找不到类 - 该方式生成的 fat jar 体积大、classloader 行为不可控，调试困难
- Spring Boot 项目慎用：Boot 的
spring-boot-maven-plugin默认不兼容这种手动 Class-Path 注入
真正麻烦的不是怎么把 jar 塞进去，而是让所有环境、所有构建链路都看到同一份依赖定义。一旦用了 systemPath，你就已经放弃了 Maven 的依赖一致性保障。
