MySQL「封包過大」錯誤徹底解決：max_allowed_packet 客戶端/伺服器雙端調整實戰

錯誤現象

ERROR 1153 (08S01): Got a packet bigger than 'max_allowed_packet' bytes
ERROR 2006 (HY000): MySQL server has gone away

核心概念

• 通訊封包：單一 SQL 語句（客戶端→伺服器）或單一結果行（伺服器→客戶端）。
• 雙端獨立設定：客戶端與伺服器各有 max_allowed_packet，必須雙邊同步調大。
• 理論上限：MySQL 5.1+ 支援 1GB（實務建議 ≤ 256MB）。

調整方法

1. 客戶端臨時調整

mysql --max_allowed_packet=32M -u root -p

2. 伺服器端永久調整（my.cnf / my.ini）

[mysqld]
max_allowed_packet = 64M

3. 客戶端永久調整（選項檔）

[mysql]
max_allowed_packet = 64M

[mysqldump]
max_allowed_packet = 64M

場景化建議值

原理與安全性

• 記憶體按需分配：僅大封包觸發時分配，預設值小是為捕捉異常封包、防止 OOM。
• 過大值風險：惡意大查詢耗盡記憶體 → OOM Killer 殺掉 mysqld。
• 配合 max_allowed_packet 設定 net_buffer_length（預設 16K），避免頻繁重新分配。

特殊情況：BLOB 大寫入仍失敗

• 檢查 ulimit -d (data segment limit)：
  ulimit -d 256000 # 250MB
  加入 mysqld_safe 腳本或 systemd LimitDATA。
• 檢查 innodb_log_file_size：單事務最大不超過 innodb_log_file_size * innodb_log_files_in_group / 10。

驗證生效

SHOW VARIABLES LIKE 'max_allowed_packet';
# 客戶端
mysql --max_allowed_packet=32M -e "SELECT @@max_allowed_packet;"

結語

max_allowed_packet 是「雙端最小值」生效原則。標準化流程：my.cnf 伺服器端設定 → 客戶端選項檔同步 → 滾動重啟驗證 → 監控大封包頻率，即可徹底消除封包過大錯誤。