您现在的位置：程式碼之家 >> 數據庫知識 > >> Oracle 資料庫 >> Oracle 資料庫基礎

Oracle 監聽器六大連線錯誤代碼速查表：12541、12500、12535、12154、12514、路徑遺失完整排查指引

編輯：Oracle 資料庫基礎

Oracle 監聽器配置錯誤導致 Client 無法連線，是 DBA 最高頻處理事件。本文將六大經典錯誤代碼整理為一頁式速查表，含錯誤含義、根因、即時指令與驗證步驟，適合列印貼於機房牆面。

架構速覽

監聽器：Server 端服務，監聽 Port (預設 1521)
本地服務名：Client 端 tnsnames.ora，描述連線目標
連線成功條件：網路通 + 監聽器啟動 + 資料庫開啟 + 服務名匹配

六大錯誤代碼完整排查表

錯誤代碼	完整訊息	根因	即時排查指令/動作	驗證
ORA-12541	TNS: no listener	監聽器未啟動	`lsnrctl start` (Linux/Win) 檢查 Client IP/Port 設定	`lsnrctl status` 顯示 READY
ORA-12500	TNS: listener failed to start dedicated server process	資料庫 Instance 未啟動	Win: `oradim -startup -sid <SID>` Linux: `sqlplus / as sysdba` → `STARTUP`	`SELECT status FROM v$instance;` = OPEN
ORA-12535	TNS: operation timed out	網路不通 / 防火牆阻擋	1. `ping <Server IP>` 2. `telnet <Server IP> 1521` 3. 雙邊防火牆開放 1521/TCP	telnet 成功顯示空白畫面
ORA-12154	TNS: could not resolve the connect identifier specified	服務名錯誤 / tnsnames.ora 格式錯	1. 確認 TNS 別名拼寫 2. 檢查 `tnsnames.ora` 首行服務名前無空格 3. `tnsping <alias>`	tnsping 返回 OK
ORA-12514	TNS: listener does not currently know of service requested in connect descriptor	服務名與監聽器註冊的不符	Net Manager → 服務識別欄 = 監聽器的 `GLOBAL_DBNAME`	`lsnrctl services` 顯示服務名匹配
Win 服務找不到路徑	啟動監聽器/Instance 服務提示路徑錯誤	註冊表 ImagePath 遺失/錯誤	監聽器: `HKLM\SYSTEM\CurrentControlSet\Services\OracleOraHome92TNSListener\ImagePath` = `D:\oracle\ora92\BIN\TNSLSNR` Instance: `HKLM\SYSTEM\CurrentControlSet\Services\OracleService\ImagePath` = `D:\oracle\ora92\bin\ORACLE.EXE <SID>`	services.msc 啟動成功

排查黃金法則

配置一致性：Client tnsnames.ora = Server listener.ora (Host, Port, Service Name)
分層驗證：ping → telnet 1521 → lsnrctl status → tnsping → sqlplus
看錯誤碼定層級：12541/12500=服務層，12535=網路層，12154/12514=配置層
註冊表修復：Windows 服務啟動失效 90% 為 ImagePath 遺失

進階：動態服務註冊驗證

lsnrctl services
# 輸出關鍵行：
Service "ORCL" has 1 instance(s).
  Instance "ORCL", status READY, has 1 handler(s)...
  Handler(s):
    "DEDICATED" established:0 refused:0 state:ready
       LOCAL SERVER

若無 status READY，檢查 LOCAL_LISTENER、SERVICE_NAMES 參數。