本地 Oracle 資料庫連線失敗：The Network Adapter could not establish the connection 排查清單

錯誤堆疊顯示 java.net.ConnectException: Connection refused，表示 TCP 連線被拒絕，非認證問題。

排查步驟

1. 監聽器狀態： lsnrctl status 確認 LISTENER 運行且監聽正確 Port (預設 1521)。
2. 資料庫實例已啟動： sqlplus / as sysdba → startup。
3. 防火牆/防毒軟體： 放行 1521 Port 或暫時關閉測試。
4. tnsnames.ora / listener.ora IP/Hostname 正確 (localhost vs 實際 IP)。
5. JDBC URL 格式： jdbc:oracle:thin:@//host:1521/SID 或 @//host:1521/ServiceName。
6. IPv6 干擾： JVM 參數 -Djava.net.preferIPv4Stack=true。

快速驗證

telnet localhost 1521
# 或
sqlplus user/pass@//localhost:1521/ORCL

參考：Oracle 連線失敗完整排查指南