// MySQL 錯誤參考

MySQL 錯誤 1153:收到的封包大於 max_allowed_packet

陳述式或資料列超過 max_allowed_packet 允許的大小,通常是大 BLOB,或從傾印檔而來的超大型多列 INSERT。請在兩端都調高上限。

錯誤號碼
1153
名稱
ER_NET_PACKET_TOO_LARGE
SQLSTATE
08S01
類別
伺服器限制與設定
錯誤訊息
Got a packet bigger than 'max_allowed_packet' bytes

它的意義

MySQL 會限制單一協定封包的大小,大約是一條送出的語句或一列傳回的資料,上限為 max_allowed_packet (MySQL 8.0 預設為 64 MB)。更大的封包會被伺服器以 1153 拒絕,而且通常會關閉連線,所以用戶端回報的可能是 2006 或 2013。

客戶端自身也有 max_allowed_packet,同樣必須夠大。

常見原因

  • 插入大型 BLOB 或 TEXT 值,例如檔案或圖片。
  • 還原含有非常長的延伸 INSERT 語句。
  • 透過限制較小的用戶端選取含非常大值的資料列。

如何修正

  1. 檢查伺服器的限制。

    SHOW VARIABLES LIKE 'max_allowed_packet';
  2. 在伺服器端調高(新連線會套用此設定),並將它保存下來。

    SET PERSIST max_allowed_packet = 256 * 1024 * 1024;
  3. 用戶端也要調高,例如 mysql --max_allowed_packet=256M,並在匯出時使用 mysqldump --max_allowed_packet=256M 或 --net-buffer-length 讓陳述式保持簡短。

相關錯誤

更多伺服器限制和設定錯誤

程式碼和訊息文字來自 MySQL 8.4 錯誤訊息參考。瀏覽完整的 MySQL 錯誤清單 或 搜尋每個資料庫錯誤.

// 錯誤更少,修復更快

在 SQLly 裡操作 MySQL

適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 MySQL 和你使用的其他資料庫。