Oracle 客戶端連線配置完整指南與故障排查

客戶端連接 Oracle 需安裝 Oracle Net 通訊層 (含於 Client 安裝)，唯 Java Thin Driver 例外。本文詳述安裝、配置 (sqlnet.ora、tnsnames.ora)、伺服器端驗證與常見錯誤排查。

客戶端安裝與配置

1. 安裝 Oracle Client (含 Oracle Net)，或已安裝 Server 則無需額外安裝。
2. sqlnet.ora 關鍵參數：

   NAMES.DIRECTORY_PATH = (TNSNAMES, ...)  -- 預設即可
   # NAMES.DEFAULT_DOMAIN = your_domain    -- 易導致 ORA-12154，建議註解

3. tnsnames.ora 定義連線別名：

   MYDB =
     (DESCRIPTION =
       (ADDRESS = (PROTOCOL = TCP)(HOST = db-server)(PORT = 1521))
       (CONNECT_DATA = (SERVICE_NAME = orcl)))

伺服器端驗證

• Listener 已啟動：lsnrctl status
• 資料庫已啟動：

  -- 9i/10g+
  sqlplus "/ as sysdba"
  SQL> STARTUP
  
  -- 8i
  svrmgrl
  SVRMGR> CONNECT INTERNAL
  SVRMGR> STARTUP

常見連線錯誤與解法

Java Thin Driver 免 Client 連線

jdbc:oracle:thin:@//host:port/service_name
// 或
jdbc:oracle:thin:@host:port:SID

系統性檢查「Client 配置 → 網路通達 → Listener → 資料庫實例 → 認證」，能快速定位 90% 連線問題。