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