解決 MySQL Error 2006「MySQL server has gone away」完整排查指南

解決 MySQL Error 2006「MySQL server has gone away」完整排查指南

Error 2006 表示客戶端與 Server 連線中斷。常見於大批量匯入、長時間閒置、大封包傳輸。本文給出配置調優與應用層重連策略。

核心配置調整 (my.cnf / my.ini)

[mysqld]
# 最大允許封包，預設 4M/64M，大批次 INSERT/大欄位需調大
max_allowed_packet = 256M

# 連線閒置超時，預設 8h (28800s)，長連線池需配合應用層心跳
wait_timeout = 28800
interactive_timeout = 28800

# 關閉 DNS 反解析，加快連線建立
skip_name_resolve = 1

修改後必須重啟 MySQL 生效。

應用層最佳實踐

• 連線池驗證：HikariCP / Druid 設定 testWhileIdle=true、validationQuery=SELECT 1、minEvictableIdleTimeMillis < wait_timeout。
• 重試機制：捕獲 2006/2013/08S01，指數退避重試 3 次（冪等操作）。
• 大批次拆分：單次 INSERT 行數控制在 1000-5000，避免超過 max_allowed_packet。
• 避免長事務：事務持有鎖時間過長易觸發鎖等待超時或主動殺掉。

排查檢查清單

1. SHOW GLOBAL VARIABLES LIKE 'max_allowed_packet'; 確認生效值。
2. SHOW GLOBAL STATUS LIKE 'Aborted_connects'; 連線被中斷計數。
3. 檢查錯誤日誌 /var/log/mysqld.log 是否有 Killed / Out of memory。
4. 監控 Threads_connected、Max_used_connections 是否觸及 max_connections。
5. 網路層：防火牆/NAT 閒置超時（通常 5-15 分鐘）切斷長連線 → 應用層心跳或 TCP Keepalive。

總結

Error 2006 本質是連線斷開。雙管齊下：Server 端調大封包與超時、關閉 DNS 反解；Client 端連線池驗證、重試、拆分大批次。建立監控告警，早發現早處理。