MySQL "Server has gone away" 錯誤排查：max_allowed_packet 實戰解決

從插入中斷錯誤定位到封包限制

專案中遇到 Error 2006: MySQL server has gone away，初以為是連線逾時，排查後發現根因是單次 SQL 封包超過 max_allowed_packet 預設 1MB 限制。本文記錄完整排查與解決流程，作為同類問題的快速參考。

1. 錯誤現象與誤區

• 大量資料 INSERT / UPDATE 執行到一半中斷
• 錯誤訊息 MySQL server has gone away 易誤判為連線斷開
• 實際上伺服器仍在運行，只是拒絕超大封包並關閉該連線

2. 確認當前配置

SHOW VARIABLES LIKE 'max_allowed_packet';
-- 回傳 1048576 (1MB)，遠小於業務所需

3. 解決方案（同 ID 181372，此處精簡）

永久修改（生產環境）

# /etc/my.cnf 或 my.ini
[mysqld]
max_allowed_packet = 64M

重啟服務：systemctl restart mysqld

臨時修改（緊急/測試）

SET GLOBAL max_allowed_packet = 209715200;  -- 200MB
-- 重新連線後生效

4. 關鍵補充：mysqldump 自動處理

MySQL 官方文檔指出：mysqldump 導出檔案會自動包含 SET @@session.max_allowed_packet=... 語句，確保導入時不受限制。若手動導入大 SQL 檔失敗，請檢查客戶端參數：

mysql --max_allowed_packet=64M -u root -p db_name < dump.sql

5. 參考資源

官方文檔：MySQL max_allowed_packet 詳細說明

6. 預防清單

• 上線前評估最大單筆 SQL 體積（含批次 INSERT 的 VALUES 列表）
• 應用層實作分批寫入邏輯（如每 500~1000 行一批）
• 監控 Aborted_clients 狀態變數，異常增長常為封包過大信號

遇到 gone away 勿慌，優先檢查封包大小，九成以上屬於此類配置問題，調大參數並分批處理即可徹底解決。