Java 透過 JDBC (Java Database Connectivity) 統一存取各類關聯式資料庫。不同資料庫的 Driver 類別、URL 格式、連線參數各異,開發者常需在專案切換資料庫時快速調整設定。本文整理 8 種主流資料庫的標準連線範本,涵蓋 Driver 載入、URL 組裝、帳密設定、連線建立,並針對常見坑點補充說明。
Class.forName(driverClass).newInstance()DriverManager.getConnection(url, user, password)Class.forName("oracle.jdbc.driver.OracleDriver").newInstance();
String url = "jdbc:oracle:thin:@localhost:1521:ORCL"; // SID
// 或服務名稱: jdbc:oracle:thin:@localhost:1521/myservice
String user = "scott";
String password = "tiger";
Connection conn = DriverManager.getConnection(url, user, password);
備註:Oracle 12c+ 建議使用服務名稱而非 SID;若使用 OCI 模式需安裝 Instant Client。
Class.forName("com.ibm.db2.jcc.DB2Driver").newInstance(); // 建議使用 JCC Driver
String url = "jdbc:db2://localhost:50000/SAMPLE"; // 資料庫名
String user = "db2admin";
String password = "password";
Connection conn = DriverManager.getConnection(url, user, password);
備註:舊版 COM.ibm.db2.jdbc.app.DB2Driver (Type 2) 已淘汰,請改用 Type 4 jcc Driver。
// Microsoft 官方 JDBC Driver (建議 10.2+)
Class.forName("com.microsoft.sqlserver.jdbc.SQLServerDriver").newInstance();
String url = "jdbc:sqlserver://localhost:1433;databaseName=MyDB;encrypt=true;trustServerCertificate=true";
String user = "sa";
String password = "StrongPassword";
Connection conn = DriverManager.getConnection(url, user, password);
備註:舊版 com.microsoft.jdbc.sqlserver.SQLServerDriver (SQL Server 2000 時代) 已不支援新版本。JDBC 10.2+ 預設啟用 TLS 加密,需在 URL 加入 encrypt=true;trustServerCertificate=true (開發環境) 或配置信任憑證 (生產環境)。
// jConnect (Type 4)
Class.forName("com.sybase.jdbc4.jdbc.SybDriver").newInstance();
String url = "jdbc:sybase:Tds:localhost:5000/MyDB";
Properties props = new Properties();
props.put("user", "userid");
props.put("password", "user_password");
// 可選: props.put("CHARSET", "utf8");
Connection conn = DriverManager.getConnection(url, props);
Class.forName("com.informix.jdbc.IfxDriver").newInstance();
String url = "jdbc:informix-sqli://123.45.67.89:1533/myDB:INFORMIXSERVER=myserver;user=testuser;password=testpassword";
Connection conn = DriverManager.getConnection(url);
Class.forName("com.mysql.cj.jdbc.Driver").newInstance(); // 5.1 版用 com.mysql.jdbc.Driver
String url = "jdbc:mysql://localhost:3306/myDB?" +
"useUnicode=true&characterEncoding=UTF-8&" +
"useSSL=false&serverTimezone=Asia/Taipei&" +
"allowPublicKeyRetrieval=true";
String user = "root";
String password = "password";
Connection conn = DriverManager.getConnection(url, user, password);
關鍵參數說明:
useUnicode=true&characterEncoding=UTF-8:確保中文正確useSSL=false:開發環境關閉 SSL;生產請啟用並配置憑證serverTimezone:避免時區警告allowPublicKeyRetrieval=true:配合 caching_sha2_password 認證Class.forName("org.postgresql.Driver").newInstance();
String url = "jdbc:postgresql://localhost:5432/myDB";
String user = "postgres";
String password = "password";
Connection conn = DriverManager.getConnection(url, user, password);
進階參數:?currentSchema=myschema&ApplicationName=MyApp
⚠ JDBC-ODBC Bridge (sun.jdbc.odbc.JdbcOdbcDriver) 已在 Java 8 移除,請改用純 Java 驅動:
// UCanAccess (支援 .accdb/.mdb)
Class.forName("net.ucanaccess.jdbc.UcanaccessDriver").newInstance();
String url = "jdbc:ucanaccess://C:/Data/ReportDemo.accdb";
Connection conn = DriverManager.getConnection(url);
Maven 依賴:org.jackcess:jackcess:3.0.1, com.healthmarketscience.jackcess:jackcess-encrypt:3.0.1, net.sf.ucanaccess:ucanaccess:5.0.1
// HikariCP 範例 (高效能連線池)
HikariConfig config = new HikariConfig();
config.setJdbcUrl(url);
config.setUsername(user);
config.setPassword(password);
config.setMaximumPoolSize(20);
config.setConnectionTimeout(30000);
DataSource ds = new HikariDataSource(config);
// 使用 try-with-resources 自動關閉
try (Connection conn = ds.getConnection();
PreparedStatement stmt = conn.prepareStatement("SELECT * FROM users WHERE id = ?")) {
stmt.setInt(1, 100);
try (ResultSet rs = stmt.executeQuery()) {
while (rs.next()) { /* 處理資料 */ }
}
}
| 現象 | 可能原因 | 解決方向 |
|---|---|---|
| ClassNotFoundException | Driver JAR 未加入 classpath | Maven/Gradle 引入正確 dependency |
| Communications link failure | IP/Port 錯誤、防火牆、資料庫未啟用 TCP | telnet 測試、檢查 my.cnf/pg_hba.conf/listener.ora |
| 中文亂碼 | 字元集不匹配 | URL 加字元集參數、資料庫/表/欄位統一 UTF-8 |
| Public Key Retrieval is not allowed | MySQL 8 新認證機制 | URL 加 allowPublicKeyRetrieval=true |
| No suitable driver | URL 格式錯誤或 Driver 未註冊 | 檢查 Driver 類別名、URL 前綴 (jdbc:subprotocol:...) |
掌握各資料庫的 JDBC 連線範本是 Java 後端開發的基本功。建議將連線參數外部化至設定檔 (YAML/Properties/環境變數),搭配連線池 (HikariCP) 與 try-with-resources,即可構建健壯、可維護的資料存取層。隨著雲端資料庫普及,亦請留意 SSL/TLS、IAM 認證、Proxy 連線等新式連線方式。