MySQL max_allowed_packet 參數配置詳解與踩坑避雷指南

大數據包傳輸失敗？一文搞懂 max_allowed_packet

當執行大批量 INSERT/UPDATE 或匯入大型 SQL 檔案時，常遇到 Packet too large 或 MySQL server has gone away 錯誤，罪魁禍首通常是 max_allowed_packet 參數設定過小。

查看當前配置

SHOW VARIABLES LIKE '%max_allowed_packet%';
-- 輸出範例：1048576 (即 1MB，預設值)

兩種修改方式

方法一：修改配置檔（永久生效，推薦）

[mysqld]
max_allowed_packet = 20M

配置檔位置查詢：mysql --help | grep my.cnf（Windows 為 my.ini）

修改後必須重啟 MySQL 服務。

方法二：運行時動態修改（臨時生效，不需重啟）

-- 注意：必須使用位元組為單位的數值表達式
SET GLOBAL max_allowed_packet = 2*1024*1024*10;  -- 20MB

-- 驗證是否生效（需重新連線）
SHOW VARIABLES LIKE '%max_allowed_packet%';

最佳實踐建議

1. 預設調大：生產環境建議直接設為 64M 或 128M，現代硬體記憶體充足
2. 客戶端同步調整：mysqldump --max_allowed_packet=128M、應用程式連線參數同步設大
3. 監控告警：監控 Aborted_clients、Connection_errors_internal 指標
4. 網路層也要配合：檢查防火牆、負載均衡器的封包大小限制

正確配置此參數，能徹底解決大 SQL 匯入、大欄位（BLOB/TEXT/JSON）讀寫失效問題。