Maven引入第三方JAR包实战指南

要将第三方提供的 JAR 包引入本地 Maven 仓库，可通过以下步骤实现（以 Oracle JDBC 驱动为例）：

---

🔧 方法 1：使用 install:install-file 命令（推荐）

1. 定位 JAR 文件

   将第三方 JAR 包（如 ojdbc11.jar）放置到本地目录（例如 D:\libs）。

2. 执行 Maven 安装命令

   在命令行中进入 JAR 所在目录，执行以下命令（参数需根据实际修改）：

   mvn install:install-file 
     -Dfile=ojdbc11.jar                      # JAR 文件路径
     -DgroupId=com.oracle.database            # 自定义 groupId
     -DartifactId=ojdbc11                     # 自定义 artifactId
     -Dversion=21.13.0.0                      # 自定义版本号
     -Dpackaging=jar                          # 打包类型

   执行后效果 ：

   JAR 会自动安装到本地仓库路径（如 ~/.m2/repository/com/oracle/database/ojdbc11/21.13.0.0/ojdbc11-21.13.0.0.jar）。

3. 在项目中引用

   在 pom.xml 中添加依赖：

   <dependency>
     <groupId>com.oracle.database</groupId>
     <artifactId>ojdbc11</artifactId>
     <version>21.13.0.0</version>
   </dependency>

---

️ 注意事项

1. 参数命名规范

   • groupId、artifactId 需符合反向域名规则 （如 com.xxx）。
   • 版本号应与实际一致，避免冲突。

2. 路径问题

   • -Dfile 需使用绝对路径 或相对路径正确指向 JAR 文件。
   • Windows 路径分隔符用 \ 或 / 均可（如 D:/libs/ojdbc11.jar）。

3. 环境验证

   执行前用 mvn -v 检查 Maven 环境是否配置正确。

---

🔄 替代方案对比

方法	适用场景	缺点
install-file 命令	通用场景，需长期使用	需手动执行命令
<systemPath> 引用	临时测试，不放入仓库	依赖需随项目分发，移植性差
IDE 直接添加库	快速调试	仅限当前项目，团队协作失效

💡 最佳实践 ：正式项目首选命令安装至本地仓库，确保构建一致性。

---

🌐 扩展：部署到私服（团队共享）

若需团队共享，可上传至 Nexus 私服：

1. 配置 settings.xml 添加私服认证：

   <server>
     <id>nexus-releases</id>
     <username>admin</username>
     <password>admin123</password>
   </server>

2. 执行部署命令：

   mvn deploy:deploy-file 
     -Dfile=ojdbc11.jar 
     -DgroupId=com.oracle.database 
     -DartifactId=ojdbc11 
     -Dversion=21.13.0.0 
     -Dpackaging=jar 
     -Durl=http://私服地址/repository/maven-releases/ 
     -DrepositoryId=nexus-releases  # 与 settings.xml 的 <server> id 一致