// 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 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 MySQL 以及你使用的其他数据库。