必须同时调大服务端和客户端max_allowed_packet参数，仅改一端必然失败；服务端需在[mysqld]段设max_allowed_packet=512m并重启，客户端如mysqldump、mysql须显式加--max-allowed-packet参数，最终生效值取二者最小值。
必须同时调大服务端 max_allowed_packet 和客户端工具（如 mysqldump、mysql 命令行）的对应参数，只改一端必然失败。
查清当前真实生效值，别信配置文件或默认值
配置文件写的值 ≠ 实际运行值，尤其在云数据库或容器化部署中常见偏差：
-
SELECT @@global.max_allowed_packet;查服务端真实值（单位字节），不是SHOW VARIABLES—— 后者可能返回会话级值，被连接池覆盖 - 对
mysqldump或mysql命令，不能靠status或猜测，默认是 16MB；必须显式加参验证 - 云数据库（如阿里云 RDS、腾讯云 CDB）通常禁用
SET GLOBAL，得去控制台改参数组，查@@global可能始终显示 4194304（4MB）
服务端配置必须写对位置、单位和重启方式
max_allowed_packet 在服务端只认 [mysqld] 段，写错段落等于没改：
- 编辑真实生效的配置文件（先执行
SHOW VARIABLES LIKE 'config_file';确认路径，常见于/etc/my.cnf或/etc/mysql/mysql.conf.d/mysqld.cnf） - 在
[mysqld]下添加：max_allowed_packet = 512M（注意：单位必须是大写M，不能是MB、m或带空格） - 改完必须
systemctl restart mysql（或service mysqld restart），mysqladmin reload不生效
mysqldump 和 mysql 导入命令必须显式传参
mysqldump 和 mysql 是独立客户端，完全不读服务端配置，也不继承 [client] 段设置：
- 导出时：
mysqldump --max-allowed-packet=512M -u root -p db_name > dump.sql（--max-allowed-packet必须放在db_name之前） - 导入时：
mysql --max-allowed-packet=512M -u root -p db_name （不能用 <code>source dump.sql，它走 session 限制） - 若 dump 文件含 BLOB 或 base64 图片，建议加
--hex-blob；含 emoji 则加--default-character-set=utf8mb4
容易被忽略的兼容性细节
迁移过程中的“半途失败”往往卡在这些隐性环节：
-
mysqldump的--max-allowed-packet单位必须大写M，写成512m或512（无单位）会导致启动失败或静默回退到默认值 - 主从复制场景下，
max_allowed_packet还影响 relay log apply；从库也要单独配[mysqld]段，否则Seconds_Behind_Master突变为NULL - 使用 JDBC 时，URL 中要加
?maxAllowedPacket=536870912（字节数），不能只靠服务端调大
