ThinkPHP批量添加数据应优先使用insertAll而非add()循环，它生成单条多值INSERT语句，速度快、无模型开销；saveAll适用于需模型逻辑的场景；大批量须分片+事务，注意字段映射、去重及内存管理。
ThinkPHP 里批量添加数据，别用 add() 循环调用——那不是批量，是自找超时和数据库连接炸掉。
insertAll 是最直接的批量插入入口
它生成一条含多组值的 INSERT INTO ... VALUES (),(),() 语句，一次执行完所有行。比循环 add() 快 10 倍以上，且不触发模型事件、验证器等额外开销。
-
Db::name('user')->insertAll($data)是最常用写法，$data必须是二维数组，每个子数组键名需严格对应数据库字段名 - TP6 默认过滤非法字段；TP5.1 遇到不存在字段会直接报错，得提前清理或用
field显式指定列 - 返回值是整数（影响行数），不是布尔值——失败时抛异常，不是返回
false，别用if ($result)判定成功 - 单次建议不超过 500 条，否则容易触发 MySQL 的
max_allowed_packet限制或 PHP 内存溢出
saveAll 适合需要模型逻辑的场景
当你依赖自动时间戳、自动验证、类型转换、模型事件（如 before_insert）时，saveAll() 是唯一选择。它内部仍走 insertAll 底层，但包裹了完整模型生命周期。
- 必须传模型实例，例如
(new User())->saveAll($data)；不能直接User::saveAll($data)（静态调用在 TP6 不支持） - 默认开启验证，若数据已清洗干净，加参数
['validate' => false]可显著提速 - 主键为自增时，返回插入后的 ID 数组；非自增主键（如 UUID）则只返回
true或false - 不要在循环里反复
new User()，复用一个实例即可
大批量导入必须分片 + 事务包裹
一次性塞 10 万行？哪怕用 insertAll 也会卡死。真实生产环境必须主动切片，并确保原子性。
立即学习“PHP免费学习笔记（深入）”；
- 用
array_chunk($data, 400)拆成每批 400 条，避免单次 SQL 过长 - 必须显式开启事务：
Db::transaction(function () use ($chunks) { foreach ($chunks as $chunk) { Db::name('user')->insertAll($chunk); } });，否则部分失败会导致脏数据 - CLI 脚本记得加
set_time_limit(0)；Web 请求务必改用队列，Nginx 默认 30 秒就断连 - 每批执行后调用
gc_collect_cycles()，尤其处理 Excel 导入后的大数组，防止内存持续上涨
常见报错和绕过方式
批量插入失败往往不是代码写错，而是约束冲突或配置越界。
-
SQLSTATE[23000]: Integrity constraint violation: 1062 Duplicate entry：说明有主键/唯一索引重复。insertAll不带INSERT IGNORE，也不会跳过。解决办法只有三个：提前去重、改用原生Db::execute('INSERT IGNORE ...')、或换replaceInto()（注意它会 DELETE 再 INSERT） -
Packets larger than max_allowed_packet are not allowed：MySQL 配置太小。临时改法是SET GLOBAL max_allowed_packet = 64*1024*1024;，但更稳妥的是切片 - Excel 导入后直接
insertAll报错字段不匹配：因为 Excel 表头是中文（如“用户名”），而数据库字段是username。必须先做字段映射，不能裸奔传数组
真正难的不是调哪个方法，而是校验来源、切分节奏、兜住异常、清理内存——这些细节不写进代码里，批量操作永远是线上事故预备役。
