// MySQL 錯誤參考

MySQL 錯誤 4031:因閒置被伺服器中斷連線

連線閒置的時間超過了 wait_timeout(或 interactive_timeout),伺服器因此關閉了它。較新的伺服器會告訴客戶端原因。

錯誤號碼
4031
名稱
ER_CLIENT_INTERACTION_TIMEOUT
SQLSTATE
HY000
類別
連線與用戶端
錯誤訊息
The client was disconnected by the server because of inactivity. See wait_timeout and interactive_timeout for configuring this behavior.

它的意義

從 MySQL 8.0.24 開始,伺服器要關閉閒置連線時,會先將這個錯誤傳送給用戶端,而不是直接斷線。用戶端會在下一個命令時看到它。這與舊版回報的 2006 (server has gone away) 是同一種情況。

常見原因

  • 在連線集區中閒置的連線,或被遺忘的互動工作階段,只要超過 wait_timeout (預設 8 小時)。
  • 過低的 wait_timeout 由主機供應商設定。

如何修正

  1. 設定連線池,淘汰或測試閒置連線,以免 wait_timeout 耗盡。

  2. 若預期會有較長的閒置時間,請調高逾時。

    SET PERSIST wait_timeout = 28800;

相關錯誤

更多連線與用戶端錯誤

程式碼和訊息文字來自 MySQL 8.4 錯誤訊息參考。瀏覽完整的 MySQL 錯誤清單 或 搜尋每個資料庫錯誤.

// 錯誤更少,修復更快

在 SQLly 裡操作 MySQL

適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 MySQL 和你使用的其他資料庫。