萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> Oracle 教學

ORA-12154 TNS 無法解析連線識別符:註冊表衝突與路徑陷阱

安裝 Oracle Developer Tools for VS.NET (ODT) 後,原有 ASP.NET 應用連線 Oracle 突然報 ORA-12154。

排查與解決

  1. 檢查註冊表 Oracle_Home:
    HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE
    Oracle_Home 被改為 E:\Program Files (錯誤)
    正確應為 E:\oracle (原安裝路徑) → 修正後重啟服務仍無效。
  2. 移除 ODT/ODP.NET:
    • 控制台 → 新增/移除程式 → 找不到 ODT,但發現 ODP.NET,移除之。
    • 手動刪除 ODT 目錄 E:\Oracle\product\10.1.0\Client_1 (提示 OCI.dll 被佔用),改為重命名目錄成功。
  3. 重啟系統,ASP.NET 應用恢復正常連線。

二次案例:升級 10.1.0 → 10.2.0 未重啟導致監聽器指向舊路徑

  1. 註冊表監聽器路徑仍指向 10.1.0,修正指向 10.2.0,重啟服務 OK。
  2. PL/SQL Developer 仍報錯 (訊息為空) → Tools → Preferences → Connection → Oracle Home / OCI Library 設為空 (自動偵測) → 正常。

隱藏陷阱:執行目錄路徑過長或含括號

使用 OracleClient.OracleConnection 時,若工作目錄路徑過長或包含特殊字元 (如括號),即使 TNS 正確也會報 ORA-12154。解決:縮短路徑、移除特殊字元、或使用絕對路徑配置 TNS_ADMIN。

總結檢查清單

  1. 註冊表 Oracle_Home 是否指向正確安裝目錄。
  2. 是否有殘留的 ODT/ODP.NET 目錄干擾,刪除或重命名。
  3. PL/SQL Developer 等工具的連線設定是否鎖定舊 Home。
  4. 應用程式工作目錄路徑是否過長/含特殊字元。
  5. 重啟 OS 釋放 DLL 鎖定。
copyright © 萬盛學電腦網 all rights reserved