Oracle 客戶端連接全攻略：tnsnames.ora、listener.ora、sqlnet.ora、常見錯誤碼 12154/12514 徹底解析

連接鏈路必備條件

• 客戶端安裝 Oracle Client（或 JDBC Thin 模式免安裝）；
• 服務端：Listener 已啟動、Database 已 OPEN。

三大配置文件職責

tnsnames.ora 標準範例

TEST =
  (DESCRIPTION =
    (ADDRESS_LIST =
      (ADDRESS = (PROTOCOL = TCP)(HOST = testserver)(PORT = 1521))
    )
    (CONNECT_DATA =
      (SERVICE_NAME = orcl.testserver.com)
    )
  )

關鍵點：HOST 需在客戶端可 ping 通；PORT 必須與 listener.ora 一致；SERVICE_NAME 需與服務端 SHOW PARAMETER service_name 一致。

DEFAULT_DOMAIN 陷阱 (ORA-12154 核心原因)

若 sqlnet.ora 含 NAMES.DEFAULT_DOMAIN = server.com，客戶端輸入 @test 會被自動改寫為 @test.server.com，導致 tnsnames.ora 找不到別名。

解決：註釋掉 NAMES.DEFAULT_DOMAIN 或在 tnsnames.ora 中使用全稱 test.server.com。

常見錯誤碼速查

關鍵術語辨析

• DB_NAME：數據庫名（≤8 字符）；
• DB_DOMAIN：域後綴；
• GLOBAL_NAME = DB_NAME.DB_DOMAIN；
• SERVICE_NAME：8i+ 引入，一庫多服務名，默認 = GLOBAL_NAME；
• SID：實例標識；
• NET SERVICE NAME：客戶端別名，實現位置透明。

終極測試步驟

1. 服務端 lsnrctl status 確認服務已註冊；
2. 客戶端 tnsping 別名 驗證解析；
3. sqlplus user/pwd@別名 完整連接；
4. GUI 工具驗證。