解決 MySQL 連線自動斷開：wait_timeout 原理與保活策略

解決 MySQL 連線自動斷開：wait_timeout 原理與保活策略

問題現象

長時間閒置的連線（預設 8 小時 = 28800 秒）會被 MySQL 主動關閉，應用再次使用該連線時拋出 Communications link failure 或 MySQL server has gone away。

查看當前超時設定

SHOW VARIABLES LIKE '%timeout%';

關鍵變數：

• wait_timeout：非互動式連線閒置超時（預設 28800 秒）。
• interactive_timeout：互動式客戶端閒置超時。
• net_read_timeout/net_write_timeout：網絡讀寫超時。

查看連線狀態

SHOW PROCESSLIST;

Time 欄顯示該連線已閒置秒數。若持續增長超過 wait_timeout，連線將被斷開。

解決方案對比

最佳實踐建議

1. **使用成熟連線池**（HikariCP 推薦），啟用 validationTimeout、idleTimeout、maxLifetime、minimumIdle。
2. 連線池驗證查詢設為 SELECT 1，testWhileIdle=true、timeBetweenEvictionRunsMillis 設定合理（如 30 秒）。
3. 應用層捕獲斷線異常，實現重試邏輯（指數退避）。
4. 監控 Threads_connected、Aborted_connects、Connection_errors_internal 等指標。

總結

單純調大 wait_timeout 治標不治本。**連線池驗證 + 應用重試** 才是生產環境穩健之道。