萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> MySQL 教學

MySQL max_allowed_packet 過小導致寫入失敗:排查與永久修復

現象

大字段(長文本、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 似乎不生效?

-- 現象:執行 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

影響範圍與風險

  • 過小: 導致大包寫入失敗、主從複制中斷(Slave 接收 Binlog 受限)、備份導入失敗。
  • 過大: 單條異常大 SQL 佔用過多內存,可能導致 OOM。建議上限 256MB~1GB,視內存而定。
  • 網絡層面: 亦受操作系統 TCP 緩衝區、MTU 影響,極大包需協同調優內核參數。

總結

永久生效改 my.cnf [mysqld] 段 + 重啟;臨時應急用 SET GLOBAL + 重新登錄驗證。客戶端工具同步加 --max_allowed_packet。建議常規設 16M~64M,大文本/Blob 業務設 256M,監控錯誤日誌中 Packet too large 關鍵字。

copyright © 萬盛學電腦網 all rights reserved