🔎【Oracle 連線斷線解決方案】SQLNET.EXPIRE_TIME 設定教學與 TCP Idle Timeout 問題排查

-

 

前言

在企業內部使用 Oracle 資料庫時，開發人員或 DBA 常常會遇到一個困擾的問題：

「查詢沒跑完就斷線」或「閒置一段時間後連線自動中斷」。

這種情況通常與 TCP Idle Timeout 有關，而在 Oracle 環境中，我們可以透過設定 SQLNET.EXPIRE_TIME 來有效避免。本文將用簡單易懂的方式，教你如何檢查與設定這個參數，並確保修改生效。



1. 問題來源：TCP Idle Timeout 是什麼？

當 Oracle 與 Client（例如 SQL Developer、應用程式）建立連線後，如果長時間沒有任何資料交換，防火牆或 NAT 裝置可能會自動切斷閒置的連線，這就是 TCP Idle Timeout 的機制。

舉例來說，如果防火牆閒置逾時時間是 60 秒，而你的 SQL 查詢需要 5 分鐘才跑完，中途沒有資料流動，就可能被強制斷線。



2. 解決方法：設定 SQLNET.EXPIRE_TIME

Oracle 提供 SQLNET.EXPIRE_TIME 參數，讓資料庫定期送出一個訊號（KeepAlive）給 Client，即使沒有資料傳輸，也能維持連線狀態。

步驟 1：找到正確的 sqlnet.ora 檔案

請注意，Oracle 安裝目錄中有兩個 sqlnet.ora：

  1. SAMPLE\sqlnet.ora（範例檔案，系統不會讀取）

  2. NETWORK\ADMIN\sqlnet.ora（真正會被 Oracle 使用） ✅

範例路徑：

C:\app\oracleadm\product\12.1.0\dbhome_1\NETWORK\ADMIN\sqlnet.ora


步驟 2：編輯 sqlnet.ora

使用 Notepad++ 或任何文字編輯器打開正確的 sqlnet.ora 檔案，新增以下設定： 

SQLNET.EXPIRE_TIME = 10

說明：

  • 單位為分鐘

  • 建議值為 10（代表每 10 分鐘送一次 KeepAlive 訊號）

  • 可依公司防火牆 TCP Idle Timeout 時間調整，例如 300 秒可設為 5 分鐘



步驟 3：重新啟動 Oracle Listener

修改完成後，必須重啟 Listener 才會生效。
在命令提示字元（CMD）輸入： 

lsnrctl stop
lsnrctl start


步驟 4：驗證設定是否生效

打開 SQL Developer 或 SQL*Plus，執行：

SHOW PARAMETER SQLNET.EXPIRE_TIME;

如果顯示 10，代表設定已生效；如果為空值，代表你可能改到 SAMPLE 資料夾的檔案，需要回到 NETWORK\ADMIN 路徑重新修改。



3. 額外建議：防火牆與 NAT 設定

即使 Oracle 側設定正確，如果網路層 TCP Idle Timeout 太短，依然可能被斷線。建議找網路管理員調整：

  • TCP Idle Timeout：至少設 300 秒（5 分鐘）以上

  • NAT Session Timeout：與 TCP Idle Timeout 一致或更高

  • Application Inspection / IDS：排除 Oracle 流量監控



4. 總結

  • SQLNET.EXPIRE_TIME 是 Oracle 提供的 KeepAlive 機制，可以有效避免因閒置導致的斷線

  • 必須修改 真正生效的 NETWORK\ADMIN\sqlnet.ora，而不是 SAMPLE 範例檔

  • 修改後要 重新啟動 Listener 才會生效

  • 也要檢查防火牆或 NAT Timeout 設定，確保網路層不會中途切斷連線



💡 如果你是 DBA 或軟體工程師，建議將這個設定納入資料庫部署標準流程，避免應用系統長查詢時被中斷。

留言

張貼留言

這個網誌中的熱門文章

🛠【ASP.NET Core + Oracle】解決 ORA-00904 "FALSE": 無效的 ID 錯誤與資料欄位動態插入顯示問題

-
  🔍 問題描述 在開發群創光電內部的 APS 排程系統（使用 ASP.NET Core + Vue 3 + Oracle），前端發生多筆錯誤訊息： Request failed with status code 500 Oracle.ManagedDataAccess.Client.OracleException: ORA-00904: "FALSE": 無效的 ID 這是 Oracle 資料庫對布林值處理不一致造成的錯誤，我們後端嘗試將某個欄位 .Where(x => x.FLAG == false) 寫法，經由 EF Core 轉成 SQL： SELECT * FROM TABLE WHERE FLAG = FALSE 而 Oracle 並不支援 FALSE 關鍵字作為布林值 → 導致查詢失敗。 🔧 解決方案 1：避免布林值直接進入 LINQ to SQL EF Core + Oracle 不支援下列語法： .Where(x => x.IsActive == false) // ❌ Oracle 無法解析 FALSE ✅ 解法 ：將布林判斷移至 .ToList() 之後，變成記憶體篩選： var list = await db.Table.Where(x => x.Version == ver).ToListAsync(); var filtered = list.Where(x => !x.IsActive).ToList(); // ✅ 在記憶體中比對布林 🔧 解決方案 2：安全轉換 SEQ_NO 為 Decimal 後端為了將前段表 APSZFRONT 的 SEQ_NO 與 APSZLCM 的 APS_PLAN_SEQ 對應，用到了這段程式碼： Convert.ToDecimal(front.SEQ_NO) 但一旦 SEQ_NO 含有英文字母（例如 GN140CHCAAE90S_20250811_1_531 ），就會丟出 FormatException → 造成 HTTP 500。 ✅ 正確寫法（TryParse 避免失敗） ： de...
閱讀完整內容

🛠【實戰排除教學】從 VS Code 的 _logger 錯誤，到 PowerShell 找不到 npm/serve，再到 Oracle ORA-03135 連線中斷——一次搞懂！

-
  前言 這篇文章把你在實務中 可能一次遇到的三類問題 整合成一篇易懂、可照做的排錯筆記： C# / EF Core ：VS Code 顯示 CS0103: The name '_logger' does not exist 前端部署預覽 ：PowerShell 說找不到 serve 、更慘的是連 npm 、 node 也找不到 Oracle 連線中斷 ：API 查詢跑一陣子後直接噴 ORA-03135: connection lost contact 我會用工程師口吻、但寫給不熟悉的人也看得懂的方式，帶你一步步修好。 一、VS Code： _logger 不存在（CS0103） 問題現象 在 catch 裡面呼叫 _logger.LogError(...) ，卻出現： CS0103: The name '_logger' does not exist in the current context 代表 類別裡沒有宣告或注入 _logger 。 正確作法：在類別中注入 Logger 類別欄位 using Microsoft.Extensions.Logging; public class ApsDataProcessor { private readonly AppDbContext _context; private readonly ILogger _logger; public ApsDataProcessor(AppDbContext context, ILogger logger) { _context = context; _logger = logger; } public async Task > GetDataByVersionA(string version) { try ...
閱讀完整內容

🔎如何在 Oracle PL/SQL 儲存過程中為文字欄位加入換行符號（CHR(10)）——以 Updlcmremark 為例

-
  前言 在企業級系統開發中，我們常會將複雜的商業邏輯封裝成 Oracle PL/SQL 的儲存過程（Stored Procedure），以便重複使用並確保邏輯一致性。 這次的案例是 修改 Updlcmremark 儲存過程 ，目的是讓產出的 REMARK 欄位在資料庫中具有「換行」格式，而不只是用逗號分隔，方便報表與前端顯示。 問題背景 原本的 Updlcmremark 過程中，對於某些資料（例如來自 APS_Z_LCM_CHECK 的 process_step 與 eq ），是直接用字串拼接的方式： v_remark := NVL(v_process_step, '') || '' || NVL(v_eq, ''); 這種寫法的缺點是： 資料之間沒有任何分隔符號，閱讀性差。 若要在前端或報表中換行，必須額外處理，不方便。 如果一個 SEQ_NO 有多筆資料，這種寫法只會取到第一筆（ FETCH 單筆），其他資料會被忽略。 改進需求 參考同系統的另一支儲存過程 Updmremark ，該過程在拼接文字時不僅使用逗號分隔，還加上換行符號： || ' ,' || CHR(10) 這樣在資料庫中儲存的內容，就會自帶換行，即使直接查詢或匯出到 Excel 報表，也能保有可讀性。 解決方案 方案一：簡單版（單筆取值加換行） 如果 unknown 游標一次只需要取一筆資料，可以直接在原本字串後加上逗號與換行符號： v_remark := NVL(v_process_step, '') || ' ' || NVL(v_eq, '') || ' ,' || CHR(10); 這樣每筆 remark 都會以「逗號 + 換行」結尾。 方案二：完整版（多筆累加加換行） 如果 unknown 游標可能有多筆資料，則應該使用 FOR rec_...
閱讀完整內容