Db::insertAll()是ThinkPHP6最直接高效的批量插入方式，底层执行单条INSERT INTO VALUES(),(),()语句，需确保数据结构一致、避免主键冲突、分批（500–1000条）并事务包裹。
ThinkPHP 6 的 Db::insertAll() 是最直接的方式
批量插入数据，优先用 Db::insertAll()，它底层走的是原生 INSERT INTO ... VALUES (),(),() 语句，效率高、事务安全、自动转义防注入。别自己拼 SQL 字符串，也别在循环里反复调用 Db::insert()——那会触发 N 次查询，性能断崖式下跌。
使用前提：所有数据结构必须一致（字段名、数量、类型），且不能含主键自增字段（除非显式指定）。
示例：
$data = [
['name' => '张三', 'age' => 25, 'status' => 1],
['name' => '李四', 'age' => 30, 'status' => 1],
['name' => '王五', 'age' => 28, 'status' => 0]
];
$result = Db::name('user')->insertAll($data);
// $result 返回影响的行数（int），失败返回 false
- 如果表有自增主键
id，数组中不要带id键；要强制指定就加进去，但得确保不冲突 -
insertAll()默认不返回插入后的 ID 列表；如需获取，得改用Db::query()手写INSERT ... RETURNING id（仅 PostgreSQL 支持） - 单次插入不宜超过 1000 条，否则可能触发 MySQL 的
max_allowed_packet限制
用模型批量保存时注意 saveAll() 的行为差异
模型类的 saveAll() 看似更“面向对象”，但它默认逐条调用 save()，本质是 N 次单条插入（或更新），不是真正的批量 SQL。只有传入 ['batch' => true] 参数，才会退化为 Db::insertAll() 底层执行。
立即学习“PHP免费学习笔记（深入）”；
错误写法（低效）：
UserModel::saveAll($data); // 默认 batch=false，慎用！
正确写法（等价于 Db::insertAll）：
UserModel::saveAll($data, ['batch' => true]);
- 即使开了
batch => true，模型的自动时间戳、自动写入等钩子仍会生效，但只运行一次（非每条数据都触发） - 如果数据中混杂了已存在主键的记录，
saveAll(..., ['batch'=>true])会报错；此时应改用replace或先查后判 - 验证规则对批量数据仍有效，但失败时整个批次回滚，不会部分插入
遇到 “Column count doesn’t match value count” 错误怎么办
这是 insertAll() 最常见的报错，根本原因是某条数据的键（字段名）与其他条不一致，比如：
$data = [
['name' => 'A', 'age' => 20],
['name' => 'B', 'age' => 25, 'email' => 'b@test.com'], // 多了一个 email
];
ThinkPHP 会取第一条数据的 key 作为字段列表，后续条目若字段数不匹配，就炸。
- 解决办法：统一用
array_map()补全缺失字段，例如array_fill_keys(['name','age','email'], null) - 开发期可用
array_column($data, null, 'name')快速检查是否重复键名（避免覆盖） - 别依赖前端传来的动态字段做批量插入，字段必须白名单校验并标准化
大数据量导入建议分批 + 关闭日志 + 手动事务
一次性插 10 万条？别硬扛。即使用了 insertAll()，也要拆成 500～1000 条/批，并关闭查询日志和开启事务包裹，否则内存爆、日志写满、锁表太久。
实操建议：
Db::startTrans();
try {
foreach (array_chunk($allData, 500) as $chunk) {
Db::name('log')->insertAll($chunk);
}
Db::commit();
} catch (\Exception $e) {
Db::rollback();
throw $e;
}
// 插入前可临时关闭日志：Db::setLogLevel(0)
- MySQL 中，
innodb_buffer_pool_size和bulk_insert_buffer_size会影响批量插入速度，生产环境需调优 - 如果表有唯一索引或外键约束，批量插入会变慢，考虑临时禁用（仅限离线导入场景）
- TP6.1+ 支持
insertAll()的ignore参数（INSERT IGNORE），但仅限 MySQL，且不报错也不返回实际插入数
saveAll() 当成真批量——这些点漏一个，线上就容易出慢查询或部分失败。 
