// MySQL 錯誤參考
MySQL 錯誤 1153:收到的封包大於 max_allowed_packet
陳述式或資料列超過 max_allowed_packet 允許的大小,通常是大 BLOB,或從傾印檔而來的超大型多列 INSERT。請在兩端都調高上限。
- 錯誤號碼
1153- 名稱
ER_NET_PACKET_TOO_LARGE- SQLSTATE
08S01- 類別
- 伺服器限制與設定
它的意義
MySQL 會限制單一協定封包的大小,大約是一條送出的語句或一列傳回的資料,上限為 max_allowed_packet (MySQL 8.0 預設為 64 MB)。更大的封包會被伺服器以 1153 拒絕,而且通常會關閉連線,所以用戶端回報的可能是 2006 或 2013。
客戶端自身也有 max_allowed_packet,同樣必須夠大。
常見原因
- 插入大型 BLOB 或 TEXT 值,例如檔案或圖片。
- 還原含有非常長的延伸
INSERT語句。 - 透過限制較小的用戶端選取含非常大值的資料列。
如何修正
-
檢查伺服器的限制。
SHOW VARIABLES LIKE 'max_allowed_packet';
-
在伺服器端調高(新連線會套用此設定),並將它保存下來。
SET PERSIST max_allowed_packet = 256 * 1024 * 1024;
-
用戶端也要調高,例如
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 和你使用的其他資料庫。