解決 ORA-12154：TNS 無法解析連線識別碼的實戰排查

問題背景

同事安裝 Oracle Client 後，ASP.NET 應用無法連線 Oracle 資料庫（OS 為 Windows XP），報錯 ORA-12154: TNS:無法解析指定的連線識別碼。先前曾遇過類似 OIC.DLL 遺失問題，重裝 Client 即可解決。此次嘗試安裝 Oracle Developer Tools for Visual Studio .NET 10.1.0.4.0 (ODT for VS.NET) 後，雖然能在 VS.NET 中瀏覽資料庫，但 ASP.NET 連線依然失敗。

排查過程與關鍵發現

1. 檢查 tnsnames.ora：檔案內容無誤，排除語法錯誤。
2. 懷疑 ODT 安裝導致 Oracle Home/ SID 衝突：檢查登錄檔 HKEY_LOCAL_MACHINE\Software\Oracle，發現 Oracle_Home 路徑被改為 E:\Program Files，實際安裝路徑為 E:\Oracle。修正後重啟無效。
3. 嘗試移除 ODT/ODP.NET：控制台找不到 ODT 卸載項，僅見 ODP.NET，將其卸載。
4. 手動清理殘留目錄：原 ODT 目錄 E:\Oracle\product\10.1.0\Client_1 仍存在，刪除時提示 OCI.dll 正在使用。改為重命名目錄成功，重啟系統後 ASP.NET 連線恢復正常。

解決方案總結

安裝 ODT for VS.NET 後出現 ORA-12154，請依序執行：

1. 修正登錄檔：確認 HKEY_LOCAL_MACHINE\Software\Oracle\Oracle_Home 指向正確的 Oracle Client 安裝路徑。
2. 卸載 ODP.NET（或 ODT for .NET，ODT 包含 ODP，屬 VS.NET 整合外掛，提供資料庫瀏覽與拖曳操作）。
3. 刪除或重命名 ODT 安裝目錄（預設 Client_1 子目錄），若檔案被鎖定請重命名後再重啟。
4. 重啟系統，重新測試 ASP.NET 連線。若仍失敗，建議重裝 Oracle Client。

延伸案例：升級 10.1.0 → 10.2.0 導致 Listener 啟動失敗

未重啟直接安裝新版導致監聽器仍指向舊路徑。處理步驟：

1. 修改登錄檔中 Listener 路徑指向新版，重啟服務。
2. PL/SQL Developer 仍報錯，將原安裝在其他磁碟的 ODP.NET 重裝至與 Oracle 10.2.0 相同路徑。
3. 在 PL/SQL Developer 中 Tools → Preferences → Oracle → Connection，將 Oracle Home 與 OCI Library 設為空白（自動偵測），連線恢復正常。

隱藏陷阱：應用程式執行路徑過長或含特殊符號

使用 OracleClient.OracleConnection 連線 Oracle 9i 時，若執行檔路徑過長或包含括號等特殊字元，即使服務名稱正確也會觸發 ORA-12154。排查時請同步檢查應用程式部署路徑。