必须同时修改服务端和所有客户端参数，仅调服务端或仅执行SET GLOBAL均会失败；查真实生效值需分别执行SELECT @@global.max_allowed_packet和SELECT @@session.max_allowed_packet，因SHOW VARIABLES默认返回可能被覆盖的session值，且云数据库常禁用SET GLOBAL，永久生效须在[mysqld]段设max_allowed_packet=512M并完整重启服务。
必须同时改服务端配置文件和所有用到的客户端参数，只调服务端或只改 SET GLOBAL 都会失败。
查当前真实生效值，别信 SHOW VARIABLES
执行 SELECT @@global.max_allowed_packet; 看服务端硬限制，再执行 SELECT @@session.max_allowed_packet; 看当前连接实际用的值。很多工具（如 Navicat、Python 连接池）建连时就协商好了 session 值，之后 SET SESSION 无效。
常见陷阱：
- 只查
SHOW VARIABLES LIKE 'max_allowed_packet'—— 它默认返回 session 值，可能被上层框架覆盖 - 在 mysql 命令行里执行
SET GLOBAL后立刻SHOW VARIABLES—— 不退出重连，看不到新 global 值 - 云数据库（如阿里云 RDS）不支持
SET GLOBAL，命令直接报错或静默忽略
永久生效：改 [mysqld] 段 + 重启，单位必须是大写 M/G
编辑配置文件（Linux：/etc/my.cnf 或 /etc/mysql/mysql.conf.d/mysqld.cnf；Windows：C:\ProgramData\MySQL\MySQL Server 8.0\my.ini），在 [mysqld] 段下加一行：
max_allowed_packet = 512M
注意：
- 不能写
512m、512MB或512—— 小写 m 被忽略，变成 512 字节；空格或单位错会导致 mysqld 启动失败 - 最大合法值是
1073741824（1G），设更大也自动截断 - 改完必须完整重启服务：
sudo systemctl restart mysql（Linux）或通过 Windows 服务管理器重启 - 主从架构下，从库的
[mysqld]段也得同步改，否则复制中断报log event entry exceeded max_allowed_packet
客户端也得配齐，否则包在本地就被截断
服务端设成 512M，不代表你的 Python 脚本、JDBC 或 mysql 命令行就能发那么大的包 —— 它们各自有独立缓冲区限制：
-
mysql命令行导入：加参数mysql --max-allowed-packet=512M -u root -p db，或在~/.my.cnf的[mysql]段写max_allowed_packet = 512M - Python
mysql-connector：初始化时传max_allowed_packet=536870912（字节数） - JDBC URL：加参数
?maxAllowedPacket=536870912 - Navicat / DBeaver：参数不可见，出错难定位，优先换命令行验证
-
mysqldump导出大表：必须加--max-allowed-packet=512M，否则 dump 文件本身生成失败
最终生效值取「服务端 global 值、客户端显式值、中间件（如代理、ORM）限制」三者最小值，漏掉任意一环都报 Packet for query is too large。
LOAD DATA INFILE 是个例外，但 local_infile 得开
LOAD DATA INFILE 不走客户端网络栈，只依赖服务端 max_allowed_packet 和 local_infile 开关。但它容易卡在两个地方：
- 服务端
local_infile默认是OFF，需在[mysqld]段加local_infile = ON并重启 - 云数据库（如腾讯云 CDB、阿里云 RDS）通常禁用
local_infile且无法开启，此时只能退回到分批INSERT或用mysqlimport
最常被忽略的是 ORM 层 —— Django、SQLAlchemy 在事务中拼多条 SQL 时可能把整段语句塞进一个 packet，即使字段本身不大，也会因拼接膨胀触发截断。
