MySQL max_allowed_packet 參數調整：解決大數據包導入失敗

導入大字段數據（長文本、Blob、批量 INSERT）時，常遇到 Got a packet bigger than 'max_allowed_packet' bytes 或 MySQL server has gone away 錯誤。根因是單個數據包超過服務端限制。

參數作用與默認值

• 作用：限制客戶端與服務端單次通信最大包大小
• 默認值：MySQL 5.6 及之前 1MB，5.7+ 默認 4MB，8.0+ 默認 64MB
• 適用範圍：全局/會話級雙模式，SET GLOBAL 需 SUPER 權限，SET SESSION 當前連接生效

修改方法

方法一：配置文件永久生效（推薦）

# my.cnf / my.ini [mysqld] 區段
[mysqld]
max_allowed_packet = 256M  # 視業務最大字段調整，建議 64M-1G

修改後重啟 MySQL 服務生效。

方法二：運行時動態調整（無需重啟）

-- 全局生效（需 SUPER 權限，重啟失效）
SET GLOBAL max_allowed_packet = 268435456;  -- 256M，單位字節

-- 會話級生效（當前連接）
SET SESSION max_allowed_packet = 268435456;

客戶端同步調整

服務端調大後，客戶端工具也需相應調整，否則仍會在發送端被截斷：

調大風險與建議值

建議值：

• 常規業務：64M（覆蓋絕大多數場景）
• 大文本/Blob：256M-512M
• 極大批量導入：1G（臨時調大，導入後恢復）

排查清單

1. 確認錯誤確為 max_allowed_packet 而非 net_read_timeout/net_write_timeout
2. 服務端 + 客戶端雙端同步調大
3. 檢查是否有超大單行數據（如未壓縮的 Base64 圖片），考慮拆分或對象存儲
4. 監控 Max_used_connections * max_allowed_packet 理論峰值內存

精準調整 max_allowed_packet，配合客戶端同步，可徹底解決大包傳輸失敗問題。