insertall()要求传入二维数组，外层为多条记录、子数组键名须严格匹配数据库字段名；不走模型逻辑，需手动处理主键、时间戳及冲突；批量插入需分片控制性能与兼容性。
insertAll 要求二维数组，键名必须匹配字段名
传给 insertAll() 的数据必须是二维数组，外层数组代表“多条记录”，每个子数组是一条记录。子数组的键名不是随便起的，它会直接映射为 SQL 中的字段名——比如 ['user_name' => 'tom', 'email' => 't@x.com']，就要求数据库表里真有 user_name 和 email 这两个列。
常见错误现象：SQLSTATE[42S22]: Column not found: 1054 Unknown column 'username' in 'field list'，原因往往是键写成了 username（少下划线），而实际字段是 user_name；或用了模型里的别名（如 name），但没配 field 映射。
- TP6 默认开启字段过滤，非法字段名会被静默丢弃，不报错也不插入——看着成功，其实少写了字段
- TP5.1 遇到非法字段直接抛异常，更容易暴露问题
- 如果字段名含空格、特殊符号，或想用表达式（如
FROM_UNIXTIME(1734278880)），insertAll()不支持，得换Db::execute()手写原生 SQL
主键和时间戳字段要不要手动填
insertAll() 不走模型逻辑，所以 create_time/update_time 不会自动填充，主键（尤其是自增 ID）也不能留空指望框架补——你得自己塞进去。
使用场景：日志归档、离线导入、从第三方系统同步数据等不需要模型钩子的场合。如果你依赖自动时间戳或需要触发 before_insert 事件，就该换用模型的 saveAll()。
- 自增主键字段可以不传，MySQL 会自动分配；但如果你传了（比如
'id' => 1001），且该值已存在，就会触发唯一冲突报错 - UUID 或字符串主键必须显式提供，否则 MySQL 插入失败（NOT NULL 约束）
- 想让
create_time填当前时间？得自己加：'create_time' => date('Y-m-d H:i:s')或time()
大批量时分片参数 $batchSize 怎么设
insertAll() 支持第二个参数指定单次插入条数，例如 Db::name('log')->insertAll($data, 200)。这不是可选项，而是强建议项——尤其当 $data 超过 1000 条时。
性能/兼容性影响：MySQL 默认 max_allowed_packet=4M，拼出来的 INSERT 语句超长就会报 Packets larger than max_allowed_packet are not allowed；PHP 内存也可能因临时拼接大字符串爆掉。
- 推荐值：200–500，兼顾网络传输、MySQL 解析开销和事务锁粒度
- 设太小（如 50）：SQL 请求次数增多，抵消批量优势
- 设太大（如 2000）：容易触碰
max_allowed_packet或 PHPmemory_limit - 注意：该参数只控制“一次执行多少条”，不改变返回值含义——仍返回总影响行数，不是每批的
重复主键或唯一索引冲突怎么处理
insertAll() 底层就是 INSERT INTO ... VALUES (),(),()，不带 IGNORE 或 ON DUPLICATE KEY UPDATE。只要有一条记录触发主键/唯一索引冲突，整个批次立刻中断，抛出 Integrity constraint violation 异常。
容易踩的坑：以为“批量”等于“容错”，结果导数据中途崩掉，还得人工查漏补缺。
- 想跳过冲突行？只能手拼
INSERT IGNORE INTO，用Db::execute()执行 - 想存在则更新、不存在则插入？用
replaceInto()（注意：它是先 DELETE 后 INSERT，可能丢失自增 ID 或触发外键级联） - 更稳妥的做法：预查重（
SELECT id FROM table WHERE key IN (...)），筛出干净数据再insertAll()
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
