萬盛學電腦網

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

ORA-12560 TNS 協議適配器錯誤:Windows 環境 ORACLE_SID 未設定快速修復

一、錯誤現象

命令列執行 sqlplus user/pwd 報錯:
ORA-12560: TNS:protocol adapter error

二、根因

Windows 環境下,Oracle Client 依賴環境變數 ORACLE_SID 判斷連接的本地實例名。未設定時,無法構建本地 Bequeath 連接,導致協議適配器錯誤。

三、即時修復 (當前 CMD 視窗生效)

C:\> SET ORACLE_SID=orcl
C:\> SQLPLUS / AS SYSDBA
-- 或
C:\> SQLPLUS user/password
關鍵點:orcl 是**實例名** (Instance Name),非 TNS 別名、非服務名、非用戶名。可在 ORACLE_HOME\database\init.ora 或服務名 OracleService 確認。

四、永久生效 (系統環境變數)

  1. 右鍵「此電腦」→「屬性」→「進階系統設定」→「環境變數」。
  2. 「系統變數」區 → 「新增」:
    變數名:ORACLE_SID
    變數值:orcl (你的實例名)
  3. 確定關閉所有對話框,**重新開啟 CMD** 驗證。

五、多實例環境切換技巧

@echo off
REM switch_sid.bat
SETLOCAL
SET ORACLE_SID=%1
ECHO Current ORACLE_SID = %ORACLE_SID%
SQLPLUS /NOLOG
ENDLOCAL

使用:switch_sid.bat orcl / switch_sid.bat prod 快速切換。

六、常見誤區

誤區正確認知
以為是 Listener 未啟動本地 Bequeath 連接不經 Listener,ORA-12560 多為 SID 未設
設定 TNS_ADMIN 即可TNS_ADMIN 指向 tnsnames.ora 目錄,不影響本地 SID 解析
用服務名代替 SID本地連接必須用 SID,遠程連接才用服務名/TNS 別名

七、進階排查 (若設定 SID 仍失敗)

  • 確認 OracleService Windows 服務處於「執行中」。
  • 檢查 %ORACLE_HOME%\network\admin\listener.ora 是否有 SID_LIST_LISTENER 靜態註冊。
  • 事件查看器 → Windows Logs → Application 找 Oracle 事件錯誤碼。
  • sqlplus / as sysdba 若報 ORA-01031,屬權限問題 (需加入 ORA_DBA 群組),非 TNS 問題。

ORA-12560 在 Windows 90% 以上案例皆為 ORACLE_SID 未設或設錯,**一條 SET 指令即可解決**,是 DBA 入門必會的「神奇咒語」。

copyright © 萬盛學電腦網 all rights reserved