Oracle 客戶端 PL/SQL Developer 連線失敗排查：tnsnames.ora 同步關鍵

PL/SQL Developer 突然無法連線，報 ORA-12545: 目標主機不存在 或 ORA-12154。核心原因：**客戶端 tnsnames.ora 中的 HOST/IP 與伺服器實際不符**。

快速定位

1. 打開客戶端 tnsnames.ora (通常在 %ORACLE_HOME%\network\admin\)。
2. 找到對應 TNS 別名的 HOST = ... 行。
3. 與伺服器實際主機名/IP 對比 (伺服器端 hostname 或 ipconfig/ifconfig)。

常見變更場景

• 伺服器重裝 OS / 更換主機名。
• DHCP 導致 IP 變更。
• DNS 解析異動。
• 遷移至新伺服器未同步客戶端配置。

三種修復方式 (由易到難)

驗證

tnsping your_tns_alias
# OK 即表示解析正確

# PL/SQL Developer 重新連線測試

預防機制

• 伺服器採用**固定 IP + 固定主機名**，並在 DNS/hosts 註冊。
• 建立「客戶端配置同步腳本」納入變更管理流程。
• 關鍵應用改用 **SCAN VIP (RAC)** 或 **Connect Timeout + Retry** 參數提高容錯。

遇到連線失敗，**先看 tnsnames.ora HOST**，80% 問題一分鐘內解決。