确认报错由max_allowed_packet引起需见“Packet for query is too large (X > Y)”等明确提示；跨版本迁移易因长字段或未拆分语句超限；服务端须在[mysqld]段设max_allowed_packet=512M并重启，客户端需显式传参--max-allowed-packet=512M。
确认报错是否真由max_allowed_packet引起
看到Packet for query is too large (X > Y)或Packets larger than max_allowed_packet are not allowed才进这条路；只报“连接中断”“导入失败”但没带具体包大小数字的，先查服务端错误日志和SELECT @@global.max_allowed_packet，别直接调参。
跨版本迁移（比如从 MySQL 5.7 导入到 8.4）时，旧版导出的INSERT可能含长TEXT/JSON字段、未拆分的批量语句，或者用了--skip-extended-insert以外的格式，单条语句体积很容易突破默认 4MB 或 16MB 限制。
- 用
head -n 1000 dump.sql | tail -n 200快速扫一眼失败位置附近的语句长度 - 如果括号里左边数字（如
8808741）明显大于右边（如4194304），基本坐实 - 云数据库（如阿里云 RDS）查
@@global.max_allowed_packet常返回 4194304（4MB），不是配置没生效，而是控制台参数组没改或没生效
服务端必须改[mysqld]段并重启
配置文件写在[client]或[mysql]段完全无效；写max_allowed_packet = 512M在[mysqld]下才管用——注意单位必须是大写M，写512MB、512m或512 M（带空格）会导致mysqld启动失败。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录，或需要将该能力封装成可公开复用的 Codex skill。
- 先执行
SHOW VARIABLES LIKE 'config_file';确认真实生效的配置路径，别改错文件 - MySQL 8.4 硬性上限是 1073741824（1GB），设成
2G最终也只认 1GB -
systemctl restart mysql必须执行，mysqladmin reload或SIGHUP不重载此参数 - 免安装版 Windows（如 MySQL 5.6 zip 包）常无
my.ini，需复制my-default.ini重命名为my.ini再改，且不能删原my-default.ini（否则启动异常）
mysql命令行客户端必须显式传参
mysql工具完全不读服务端配置，也不继承[client]段设置；它默认上限是 16MB，哪怕服务端已设为 512MB，不加参照样卡在第一条超限语句。
- 导入命令必须写成：
mysql --max-allowed-packet=512M -u root -p db_name -
--max-allowed-packet参数必须放在db_name之前，顺序错会当数据库名解析 - 单位必须大写
M，写512m或512（无单位）会静默回退到默认值 - 别用
source dump.sql在交互式 mysql 中执行——它走的是 session 级限制，得先SET SESSION max_allowed_packet = 536870912;
跨版本兼容性容易被忽略的点
MySQL 5.7 导出的 SQL 在 8.4 上导入，除了包大小，还可能触发协议或字符集层面的隐性截断：比如含 emoji 的utf8mb4字段在旧版导出时没加--default-character-set=utf8mb4，导入时单条语句实际字节数翻倍；或者 JSON 字段嵌套过深，MySQL 8.4 解析器生成的内部包比 5.7 更大。
- 导出端（源库）建议加：
mysqldump --max-allowed-packet=512M --hex-blob --default-character-set=utf8mb4 --skip-extended-insert -
--skip-extended-insert强制每行一条 INSERT，单语句体积可控，适合调试定位 - 若用 JDBC 或 ORM 写入，连接串必须加
maxAllowedPacket=536870912，PDO 要设PDO::MYSQL_ATTR_MAX_BUFFER_SIZE - LOAD DATA INFILE 不走客户端缓冲，但云环境通常禁用
local_infile，此时只能换mysqlimport或手动拆 INSERT
