WebLogic 8.1 整合 MySQL JDBC 驅動：CLASSPATH 設定快速指南

WebLogic 啟動腳本修改是整合第三方 JDBC 驅動最直接的方式。本文示範在 WebLogic 8.1 中將 MySQL Connector/J 加入系統 CLASSPATH 的具體步驟。

修改啟動腳本

編輯 \bea\user_projects\domains\mydomain\startWebLogic.cmd（Windows）或 startWebLogic.sh（Linux）：

rem 找到 SET CLASSPATH= 那一行，在最前面加入 mysql-connector-java.jar 完整路徑
set CLASSPATH=C:\mysql-connector-java-5.1.48.jar;%WEBLOGIC_CLASSPATH%;%POINTBASE_CLASSPATH%;%JAVA_HOME%\jre\lib\rt.jar;%WL_HOME%\server\lib\webservices.jar;%CLASSPATH%

關鍵原則

• 放在最前面：確保 WebLogic 優先載入 MySQL 驅動，避免衝突
• 使用完整路徑：避免相對路徑在不同工作目錄失效
• 版本對應：MySQL 5.7+ 需用 Connector/J 5.1.x 或 8.0.x，對應 Java 版本

驗證方式

1. 重啟 WebLogic：startWebLogic.cmd
2. 進入 Console → Services → Data Sources → 新增 Generic Data Source
3. Database Type: MySQL，Driver: com.mysql.jdbc.Driver
4. 連線測試成功即完成整合

現代替代方案

WebLogic 12c/14c 建議使用 共享庫 部署 JDBC 驅動：

# 1. 將 jar 打包為 shared library (war/ear)
# 2. Console → Deployments → Install → 選擇 Library
# 3. Data Source 設定時 Library Name 指向該共享庫

優點：不修改啟動腳本、多域共用、版本隔離、熱部署。

結語

修改 startWebLogic.cmd 是舊版 WebLogic 整合 JDBC 最快路徑；新版專案請採用共享庫機制，符合 Java EE / Jakarta EE 規範與運維最佳實務。