insertAll单次最多建议不超过500条，因受MySQL max_allowed_packet和PDO参数绑定限制；超限会触发“Packets larger than max_allowed_packet”错误或内存耗尽，实际应按300～500条分批，并配合try/catch与事务控制。
insertAll 单次最多插多少条？别超 500 条
单次 insertAll() 建议控制在 500 条以内，这是 MySQL 和 PHP 双重限制下的安全阈值。超了容易触发 Packets larger than max_allowed_packet are not allowed 错误，尤其当字段含长文本、JSON 或二进制数据时，实际能塞的行数会更少。
MySQL 默认 max_allowed_packet=4M，一条含 10 个字段（平均每字段 200 字节）的记录约占 2KB，500 条就是 1MB —— 看似宽松，但 PDO 绑定参数、SQL 拼接开销、字符编码膨胀（如 UTF8MB4）会让真实体积翻倍。线上环境建议压到 300～500 条/批，并在部署前用 SHOW VARIABLES LIKE 'max_allowed_packet'; 核实实际值。
- TP6 的
insertAll($data, $limit)第二个参数可自动分片，比如insertAll($data, 300)会把 1 万条切为 34 批执行 - 不要依赖框架“自动优化”——它只做简单切片，不检查每批 SQL 长度，仍可能某一批超限
- 若明确知道数据极轻（全数字+短字符串），可试探性提到 800，但必须配合
try/catch捕获PDOException并降级重试
为什么不是 1000 条？看 MySQL 的 packet size 和 PDO 行为
insertAll() 底层拼的是单条 INSERT INTO table (a,b) VALUES (1,2), (3,4), ...，整条 SQL 作为一个 packet 发给 MySQL。一旦超过 max_allowed_packet，MySQL 直接拒收，PDO 抛出 SQLSTATE[08S01]，框架不会自动拆包重试。
另一个隐形限制是 PDO 的参数绑定上限。虽然没硬编码限制，但过长的参数数组会导致 PHP 内存分配失败或 GC 延迟，表现为脚本卡死、Fatal error: Allowed memory size exhausted，而非明确报错。
立即学习“PHP免费学习笔记（深入）”；
- 用
Db::execute()手写原生 SQL 也受同样限制，只是绕过了模型验证，不解决 packet size 问题 -
Db::name('x')->limit(1000)->insertAll($data)中的limit是框架级切片指令，不是 SQL 的 LIMIT 子句，别混淆 - Windows 下某些旧版 MySQL 客户端库对 packet 解析更敏感，同一批数据在 Linux 跑得通，在 Windows 可能报错
大批次数据必须自己分段，框架不帮你兜底
ThinkPHP 不会在 insertAll() 内部做智能流式分批。传入 10 万条二维数组，它要么全成功，要么在第 501 条附近因 packet 超限崩溃，或者耗尽内存被 PHP 中断。你得主动切片，且切片逻辑要放在事务之外或严格控制事务粒度。
- 推荐按固定大小切：用
array_chunk($data, 300)得到批次数组，再逐批insertAll() - 避免在循环内反复 new 模型或调用
Db::name()，复用同一个 Query 实例减少开销 - 每批插入后调用
gc_collect_cycles()，尤其处理百万级导入时，能明显缓解内存缓慢增长 - 别把整个 Excel 全 load 到内存再切片——用 Spout 流式读取，边读边 chunk，否则 PHP 内存先爆
insertAll 返回值不是“成功与否”的可靠依据
insertAll() 成功时返回 int 类型的影响行数，但这个数字可能有误导性。例如：某批 500 条里前 499 条成功、最后 1 条因唯一键冲突导致整批回滚，PDO 在 strict mode 关闭时可能仍返回 499，而不抛异常。
- 必须用
try/catch包裹每批操作，捕获\think\db\exception\DataNotFoundException和PDOException - 事务中执行多批
insertAll()，不能只在最外层 try，否则某批失败后后续批次仍会执行 - 日志里记下每批的起始 key 和返回值，出问题时能快速定位是哪几百条出了状况
