MySQL 錯誤 2006 "MySQL server has gone away" 根因分析與三大解決方案

MySQL 錯誤 2006 "MySQL server has gone away" 根因分析與三大解決方案

錯誤 `2006 - MySQL server has gone away` 表示客戶端與伺服器的連線意外中斷。常見於大量資料匯入、長時間查詢、網路不穩等場景。

錯誤現象

[Err] 2006 - MySQL server has gone away

三大核心原因與解決方案

1. 封包過大超過 `max_allowed_packet`（最常見）

場景：`mysqldump` 匯入大 SQL、批次 INSERT 超長、大欄位(BLOB/JSON)寫入。

檢查當前值：

SHOW VARIABLES LIKE 'max_allowed_packet';

解決：

• 臨時生效：`SET GLOBAL max_allowed_packet = 1073741824;` (1GB)
• 永久生效：`my.cnf` 中 `[mysqld]` 區段加入 `max_allowed_packet = 1G`
• 客戶端同步設定：`mysql --max_allowed_packet=1G` 或程式碼連接字串設定

2. 連線空閒超時被伺服器斷開

場景：應用連線池連線閒置超過 `wait_timeout` (預設 8小時)，伺服器主動斷開，應用再用時拋錯。

解決：

• 應用層(推薦)：連線池啟用 `validationQuery`/`testOnBorrow`，定期驗證連線有效性（HikariCP 預設開啟）
• 調大伺服器端：`SET GLOBAL wait_timeout = 86400;` (24小時) + `interactive_timeout`
• 客戶端重連邏輯：捕獲 2006/2013 錯誤碼自動重試

3. 伺服器進程崩潰或重啟

排查：

• 檢查錯誤日誌：`/var/log/mysql/error.log` 或 `mysqld.log`
• 檢查系統日誌：`dmesg -T | grep -i mysql`、 `journalctl -u mysqld`
• 常見原因：OOM Killer 殺殺進程、磁碟滿、核心 Bug、硬體故障

快速診斷清單

應用層最佳防禦程式碼

# Python (PyMySQL) 範例
import pymysql
from pymysql.err import OperationalError
import time

def execute_with_retry(sql, max_retries=3):
    for attempt in range(max_retries):
        try:
            with conn.cursor() as cursor:
                cursor.execute(sql)
                return cursor.fetchall()
        except OperationalError as e:
            if e.args[0] in (2006, 2013):  # Gone away / Lost connection
                if attempt == max_retries - 1:
                    raise
                time.sleep(2 ** attempt)  # 指數退避
                conn.ping(reconnect=True)  # 重連
            else:
                raise

預防性配置建議

[mysqld]
max_allowed_packet = 256M          # 根據最大業務欄位預留
wait_timeout = 28800               # 8小時，配合應用層驗證
interactive_timeout = 28800
net_read_timeout = 60              # 跨機房可調 300
net_write_timeout = 60
innodb_buffer_pool_size = 70% RAM  # 減少磁碟 IO 導致的查詢超時