安裝 Oracle Developer Tools for VS.NET (ODT) 後,原有 ASP.NET 應用連線 Oracle 突然報 ORA-12154。
排查與解決
- 檢查註冊表 Oracle_Home:
HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE
Oracle_Home 被改為 E:\Program Files (錯誤)
正確應為 E:\oracle (原安裝路徑) → 修正後重啟服務仍無效。
- 移除 ODT/ODP.NET:
- 控制台 → 新增/移除程式 → 找不到 ODT,但發現 ODP.NET,移除之。
- 手動刪除 ODT 目錄
E:\Oracle\product\10.1.0\Client_1 (提示 OCI.dll 被佔用),改為重命名目錄成功。
- 重啟系統,ASP.NET 應用恢復正常連線。
二次案例:升級 10.1.0 → 10.2.0 未重啟導致監聽器指向舊路徑
- 註冊表監聽器路徑仍指向 10.1.0,修正指向 10.2.0,重啟服務 OK。
- PL/SQL Developer 仍報錯 (訊息為空) → Tools → Preferences → Connection → Oracle Home / OCI Library 設為空 (自動偵測) → 正常。
隱藏陷阱:執行目錄路徑過長或含括號
使用 OracleClient.OracleConnection 時,若工作目錄路徑過長或包含特殊字元 (如括號),即使 TNS 正確也會報 ORA-12154。解決:縮短路徑、移除特殊字元、或使用絕對路徑配置 TNS_ADMIN。
總結檢查清單
- 註冊表
Oracle_Home 是否指向正確安裝目錄。
- 是否有殘留的 ODT/ODP.NET 目錄干擾,刪除或重命名。
- PL/SQL Developer 等工具的連線設定是否鎖定舊 Home。
- 應用程式工作目錄路徑是否過長/含特殊字元。
- 重啟 OS 釋放 DLL 鎖定。