MySQL 導入大 SQL 文件報錯 2006 (MySQL server has gone away) 根因與修復

MySQL 導入大 SQL 文件報錯 2006 (MySQL server has gone away) 根因與修復

現象：導入 10MB+ SQL 腳本時，報錯 Error 2006 - MySQL server has gone away。小文件正常。根因：**單條 SQL/數據包超過 max_allowed_packet 默認限制（4MB/16MB），導致連接被服務端斷開**。

錯誤堆疊示例

# 編輯 my.cnf [mysqld] 區
[mysqld]
max_allowed_packet = 300M      # 最大允許封包（建議 100M-1G，視最大 SQL 大小）
wait_timeout = 200000          # 非交互超時秒數（防長事務斷開）
interactive_timeout = 200000   # 交互超時秒數

# 重啟生效
service mysql restart
# 或動態生效（僅當前連接，重啟失效）
SET GLOBAL max_allowed_packet = 300*1024*1024;
SET GLOBAL wait_timeout = 200000;

參數詳解

客戶端同步調大（必須雙端生效）

場景典型原因排查重點

導入大 SQL封包超限max_allowed_packet
長時間無操作空閒超時wait_timeout / interactive_timeout
大事務提交鎖等待/鎖超時innodb_lock_wait_timeout
主從同步中斷網絡抖動/從庫慢slave_net_timeout / heartbeat
連接池驗證失敗後端已斷開驗證查詢 / 驗證間隔


「MySQL server has gone away」90% 是封包或超時，雙端調大、寫配置、重啟驗證，三步解決。