Oracle 客戶端連接流程由三大配置文件協同完成。理解它們的**職責分工、加載順序、關鍵參數**,是解決 TNS-12154、ORA-12514、ORA-12541 等連接錯誤的核心技能。
| 文件 | 角色類比 | 核心職責 | 典型位置 |
|---|---|---|---|
| sqlnet.ora | 命名服務開關 (/etc/nsswitch.conf) | 決定連接標識符解析順序:TNSNAMES、LDAP、HOSTNAME、EZCONNECT | $ORACLE_HOME/network/admin |
| tnsnames.ora | 主機映射表 (/etc/hosts) | TNS 別名 → 連接描述符(協議、主機、端口、服務名/SID) | $ORACLE_HOME/network/admin |
| listener.ora | 服務端監聽配置 | 定義監聽器名稱、端口、協議、服務實例註冊信息 (SID/GLOBAL_DBNAME) | $ORACLE_HOME/network/admin (服務端) |
sqlplus sys/oracle@orcl
NAMES.DIRECTORY_PATH = (TNSNAMES, HOSTNAME)
sqlnet.ora → 解析順序:TNSNAMES 優先tnsnames.ora 中 ORCL 條目(HOST=127.0.0.1)(PORT=1521)(SERVICE_NAME=orcl)listener.ora 中 SID_NAME=orcl 或 GLOBAL_DBNAME=orclNAMES.DIRECTORY_PATH = (HOSTNAME)
客戶端將 orcl 視為主機名,嘗試 DNS/hosts 解析 IP,連接該 IP 上 GLOBAL_DBNAME=orcl 的實例。**不讀取 tnsnames.ora**。
LISTENER =
(DESCRIPTION_LIST =
(DESCRIPTION =
(ADDRESS = (PROTOCOL = TCP)(HOST = 127.0.0.1)(PORT = 1521))
)
)
SID_LIST_LISTENER =
(SID_LIST =
(SID_DESC =
(GLOBAL_DBNAME = orcl) # 供 HOSTNAME 方式匹配
(ORACLE_HOME = /u01/app/oracle/product/19c)
(SID_NAME = orcl) # 供 TNSNAMES 方式匹配
)
)
| 錯誤碼 | 核心原因 | 檢查重點 |
|---|---|---|
| TNS-12154 / ORA-12154 | 無法解析連接標識符 | sqlnet.ora NAMES.DIRECTORY_PATH、tnsnames.ora 別名拼寫、文件位置 |
| ORA-12514 | 監聽器不識別服務 | listener.ora SID_LIST、GLOBAL_DBNAME、服務實例註冊狀態 (lsnrctl services) |
| ORA-12541 | 無監聽器 | 監聽器進程狀態、端口衝突、防火牆、listener.ora ADDRESS |
| ORA-12545 | 目標主機/對象不存在 | tnsnames.ora HOST IP 可達性、DNS/hosts 解析 |
SERVICE_NAME 而非 SID(支援 RAC/Data Guard 切換)sqlnet.ora 固定:NAMES.DIRECTORY_PATH=(TNSNAMES,EZCONNECT)SUBSCRIBE_FOR_NODE_DOWN_EVENT 加快故障檢測TNS_ADMIN 環境變量引用