萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> Oracle 教學

Oracle Net Services 故障診斷全指南:listener.ora、sqlnet.ora、tnsnames.ora 三大配置文件深度解析

網絡架構核心三件套

所有配置文件位於 `$ORACLE_HOME/network/admin/`,掌握它們的職責鏈路,是解決 90% 連接問題的鑰匙。

文件角色類比關鍵參數
sqlnet.ora客戶端名稱解析策略Linux `/etc/nsswitch.conf``NAMES.DIRECTORY_PATH`
tnsnames.oraTNS 別名 → 連接描述符映射Linux `/etc/hosts`服務名、協議、主機、端口
listener.ora監聽器服務註冊與監聽端點Web Server `nginx.conf``LISTENER`、`SID_LIST_LISTENER`

sqlnet.ora:解析順序的總開關

SQLNET.AUTHENTICATION_SERVICES = (NTS)
NAMES.DIRECTORY_PATH = (TNSNAMES, HOSTNAME, EZCONNECT)

當客戶端執行 `sqlplus sys/oracle@orcl` 時:

  1. 優先查 `tnsnames.ora` 找 `orcl` 記錄。
  2. 找不到則嘗試將 `orcl` 作為主機名解析 IP(`HOSTNAME`)。
  3. 再嘗試 EZCONNECT 格式 `host:port/service`。
  4. 若改為 `NAMES.DIRECTORY_PATH = (TNSNAMES)`,則僅查本地 tnsnames,失敗即報錯 `ORA-12154`。

tnsnames.ora:連接描述符詳解

ORCL =
  (DESCRIPTION =
    (ADDRESS_LIST =
      (ADDRESS = (PROTOCOL = TCP)(HOST = 127.0.0.1)(PORT = 1521))
    )
    (CONNECT_DATA =
      (SERVER = DEDICATED)        -- 專用服務器模式
      (SERVICE_NAME = orcl)       -- 對應服務端 service_names 參數
    )
  )

SALES =
  (DESCRIPTION =
    (ADDRESS = (PROTOCOL = TCP)(HOST = 192.168.1.100)(PORT = 1521))
    (CONNECT_DATA =
      (SERVER = SHARED)           -- 共享服務器模式
      (SERVICE_NAME = sales)
    )
  )

關鍵點:

  • `SERVICE_NAME` 優於 `SID`(支援多實例服務、Data Guard 切換)。
  • `SERVER = DEDICATED|SHARED` 需與服務端 `DISPATCHERS` 參數配合。
  • 支援 `LOAD_BALANCE=ON`、`FAILOVER=ON` 實現客戶端負載均衡與故障轉移。

listener.ora:服務端註冊與監聽

LISTENER =
  (DESCRIPTION_LIST =
    (DESCRIPTION =
      (ADDRESS = (PROTOCOL = TCP)(HOST = 0.0.0.0)(PORT = 1521))
      (ADDRESS = (PROTOCOL = IPC)(KEY = EXTPROC1521))
    )
  )

SID_LIST_LISTENER =
  (SID_LIST =
    (SID_DESC =
      (GLOBAL_DBNAME = orcl)
      (ORACLE_HOME = /u01/app/oracle/product/19c/dbhome_1)
      (SID_NAME = orcl)
    )
  )

動態註冊 vs 靜態註冊:

  • 動態註冊(PMON 定期向監聽器註冊 `SERVICE_NAME`、`INSTANCE_NAME`):**無需** `SID_LIST_LISTENER`,支援負載均衡、服務名路由。
  • 靜態註冊(`SID_LIST_LISTENER`):用於 Data Guard 物理備庫、外部過程、或資料庫未啟動時的連接。

常見故障診斷流程圖

  1. ORA-12154 (TNS:could not resolve) → 檢查 `sqlnet.ora` 解析順序、`tnsnames.ora` 別名拼寫、`NAMES.DIRECTORY_PATH` 包含 TNSNAMES。
  2. ORA-12541 (No listener) → `lsnrctl status` 確認監聽器運行、`listener.ora` 端口/主機匹配、防火牆放行 1521。
  3. ORA-12514 (Service not known) → 服務端 `service_names` 參數與 `tnsnames.ora` `SERVICE_NAME` 不一致,或實例未向監聽器註冊(檢查 `local_listener` 參數)。
  4. ORA-12505 (SID not known) → 使用 SID 連接但實例未靜態註冊,改用 `SERVICE_NAME` 或添加靜態註冊。

進階調試工具

  • `tnsping `:驗證別名解析與監聽器可達性(不建立會話)。
  • `sqlplus -L user@alias`:快速失敗模式,避免長時間等待。
  • 啟用客戶端/服務端 Trace:`sqlnet.ora` 添加 `TRACE_LEVEL_CLIENT=16`、`TRACE_DIRECTORY_CLIENT=/tmp`。

總結

「客戶端解析 → 監聽器接管 → 服務端註冊匹配」三階段鏈路清晰後,連接問題本質上是配置不一致。建議將三個文件納入版本控制,變更走審批流程,杜絕「改完就好」的運維陋習。

copyright © 萬盛學電腦網 all rights reserved