max_allowed_packet是mysql服务端单次接收/返回数据包的最大字节数，用于约束blob、超长文本、load data等操作；默认4mb或1mb，超限即报“packet for query is too large”，须在配置文件[mysqld]段设值（如64m）并重启服务，且需同步配置客户端参数。
max_allowed_packet 是什么，为什么改它
max_allowed_packet 控制 MySQL 服务端单次接收/返回的数据包最大字节数。不是“查询长度限制”，而是网络通信层的硬边界：INSERT 的 BLOB、SELECT 返回的超长文本、LOAD DATA 的大文件、甚至 Navicat 导出时的一整条 INSERT 语句，都受它约束。默认值在不同版本里是 4MB 或 1MB，但只要实际数据包（比如一条含 5MB JSON 字段的 INSERT）超过这个值，就会报 Packet for query is too large (X > Y)。
改配置文件才是真生效，set global 只是临时补丁
在 MySQL 命令行执行 set global max_allowed_packet = 67108864 确实能立刻让当前会话和后续新连接生效，但只要 MySQL 进程重启，就退回到配置文件里的原始值。而大多数生产环境（Docker、云数据库、Homebrew 安装）根本不会用你本地改的那个 my.cnf——你改了也白改。
- 先确认 MySQL 实际加载哪个文件：
SHOW VARIABLES LIKE 'config_file'; - 必须把
max_allowed_packet = 64M写进该文件的[mysqld]段下，不能写在[client]或文件开头无段落处 - 单位只认
K、M、G（大写），64MB、64m、64 * 1024 * 1024全部无效，MySQL 启动直接失败
改完不重启服务，等于没改
max_allowed_packet 是启动时读取的静态参数，运行中无法重载。改完配置文件后，必须完整重启 MySQL 服务：
- Linux（systemd）：
sudo systemctl restart mysqld或sudo systemctl restart mysql（看服务名） - macOS（Homebrew）：
brew services restart mysql - Windows：
net stop MySQL80 && net start MySQL80（服务名以实际为准） - 验证是否生效：
SHOW VARIABLES LIKE 'max_allowed_packet';，看到的值必须和你写的完全一致
别漏掉客户端侧的隐性限制
即使服务端设成 512M，JDBC 连接串里没配 maxAllowedPacket，驱动仍可能按默认值截断；Navicat 导入大 SQL 文件时，它自己的“发送缓冲区”也可能卡住。常见遗漏点：
- JDBC URL 加参数：
?maxAllowedPacket=536870912（单位字节） - Navicat 执行大脚本前，检查「工具 → 选项 → SQL 编辑器 → SQL 执行」里的「最大结果集大小」和「SQL 脚本执行缓冲区」是否足够
- Docker 环境要确认
my.cnf是通过 volume 正确挂载进容器的，而不是只改了宿主机文件
最常被忽略的是：你以为改的是主库，其实程序连的是从库或中间件代理（比如 ProxySQL、MaxScale），那些地方也要单独调参。
