Maven 手動安裝 Oracle 11g/12c JDBC 驅動 (ojdbc6/ojdbc7/ojdbc8) 至本地/私服倉庫完整步驟

Maven 手動安裝 Oracle JDBC 驅動完整步驟

Oracle JDBC 驅動因授權限制**不在 Maven Central**，專案需手動安裝至本地倉庫或私服。

第一步：確認 Oracle 版本與對應驅動包

查詢當前資料庫版本：

SELECT * FROM v$version;
-- Oracle Database 11g Enterprise Edition Release 11.2.0.4.0 - 64bit Production

第二步：取得驅動 JAR

1. 從 Oracle 官網下載 (需 OTN 帳號)：
   Database → JDBC/UCP → Download ojdbc6.jar / ojdbc7.jar / ojdbc8.jar
2. 或從已安裝的 Oracle Home 複製：
   `$ORACLE_HOME/jdbc/lib/ojdbc6.jar`

第三步：安裝至本地倉庫 (Local Repository)

關鍵：JAR 必須放在用戶家目錄下執行命令 (Windows: `C:\Users\\`，Linux: `~/`)，否則 `-Dfile` 相對路徑易失敗。

# 11g R2 範例 (ojdbc6.jar)
cd ~
cp /path/to/ojdbc6.jar .

mvn install:install-file \
  -DgroupId=com.oracle \
  -DartifactId=ojdbc6 \
  -Dversion=11.2.0.4 \
  -Dpackaging=jar \
  -Dfile=ojdbc6.jar \
  -DgeneratePom=true

成功輸出範例

[INFO] Installing /home/user/ojdbc6.jar to /home/user/.m2/repository/com/oracle/ojdbc6/11.2.0.4/ojdbc6-11.2.0.4.jar
[INFO] Installing /home/user/ojdbc6.jar to /home/user/.m2/repository/com/oracle/ojdbc6/11.2.0.4/ojdbc6-11.2.0.4.pom
[INFO] BUILD SUCCESS

第四步：部署至私服

mvn deploy:deploy-file \
  -DgroupId=com.oracle \
  -DartifactId=ojdbc6 \
  -Dversion=11.2.0.4 \
  -Dpackaging=jar \
  -Dfile=ojdbc6.jar \
  -Durl=https://nexus.example.com/repository/maven-releases/ \
  -DrepositoryId=nexus-releases \
  -DgeneratePom=true

settings.xml 需配置 `server` id 對應 `nexus-releases` 的認證。

第五步：專案引用

  com.oracle
  ojdbc6
  11.2.0.4

常見問題與解決

進階：使用 Oracle Maven 同步外掛 (12.2+)

Oracle 12.2+ 提供官方 Maven 外掛自動同步驅動至本地/私服：

mvn com.oracle.maven:oracle-maven-sync:push \
  -DoracleHome=/u01/app/oracle/product/12.2.0/dbhome_1 \
  -DserverId=nexus-releases

最佳實踐：新專案**直接使用 `ojdbc8` (12.2.0.1+)**，相容 Oracle 11.2.0.4+、12c、18c、19c、21c，避免多版本維護地獄。