大字段(長文本、Blob、批量 INSERT)寫入報錯:Packet too large / Got a packet bigger than 'max_allowed_packet' bytes,後續寫入也可能失敗。
SHOW VARIABLES LIKE 'max_allowed_packet';
默認常為 1048576(1MB)或 4194304(4MB),單位**字節**。
[mysqld]
max_allowed_packet = 64M # 根據業務最大單條數據評估,建議 16M~256M
查找配置文件位置:
mysql --help | grep -A1 'Default options' # 輸出讀取順序
# 典型路徑:/etc/my.cnf /etc/mysql/my.cnf /usr/local/mysql/etc/my.cnf
SET GLOBAL max_allowed_packet = 67108864; -- 64M = 64*1024*1024
-- 或
SET GLOBAL max_allowed_packet = 64*1024*1024;
注意: 動態修改後,**必須斷開重連** 新會話才能生效,舊會話仍受舊限制。
-- 現象:執行 SET GLOBAL 後 SHOW VARIABLES 仍顯示舊值
SET GLOBAL max_allowed_packet = 16M; -- 可能不生效(某版本解析問題)
SET GLOBAL max_allowed_packet = 2*1024*1024*10; -- 寫具體字節數通常穩妥
-- 關鍵步驟:退出當前客戶端,重新登錄再查看
mysql> \q
$ mysql -u root -p
mysql> SHOW VARIABLES LIKE 'max_allowed_packet'; -- 此時顯示新值
原因:會話級變量在連接建立時從全局變量複製,動態修改全局變量**不影響已建立的會話**。
mysqldump、mysql 客戶端有獨立的 max_allowed_packet 限制,導出/導入大數據時需同步調大:
mysqldump --max_allowed_packet=256M -u root -p db > dump.sql
mysql --max_allowed_packet=256M -u root -p db < dump.sql
永久生效改 my.cnf [mysqld] 段 + 重啟;臨時應急用 SET GLOBAL + 重新登錄驗證。客戶端工具同步加 --max_allowed_packet。建議常規設 16M~64M,大文本/Blob 業務設 256M,監控錯誤日誌中 Packet too large 關鍵字。