Db::insertAll()是真正预处理+单条多值SQL的批量插入，性能远超循环insert()或saveAll()；单次建议500–1000条（5字段内），字段越多则数量越少，需避max_allowed_packet限制；默认无需手动事务；禁用调试与日志可显著提升IO性能。
直接用 Db::insertAll()，别绕弯子。它不是语法糖，是真正走预处理 + 单条多值 SQL 的批量写入，性能碾压循环 insert() 或 saveAll()。
单次插多少条才不翻车
不能看别人说“1000 条”，得看你字段数和内容类型：
- 5 个字段以内（比如
name、email、status），单次insertAll()控制在 500–1000 条较稳 - 10+ 字段（含
json、text等大字段），建议压到 200–300 条 - 字段含长文本或 Base64 图片字段？单次别超 100 条，否则容易触发 MySQL 的
max_allowed_packet错误：Packets larger than max_allowed_packet are not allowed - CLI 脚本跑大批量时，记得用
array_chunk($data, 400)拆分，并在每批后调用gc_collect_cycles()防止内存持续上涨
事务要不要手动包一层
90% 的纯导入场景——不用。
Db::insertAll() 默认就是一条原子 SQL，MySQL 自动走隐式事务提交。手动套 Db::transaction() 反而延长锁持有时间，高并发下容易引发锁等待甚至超时。
立即学习“PHP免费学习笔记（深入）”；
只在以下两种情况才必须加事务：
- 插入这批数据的同时，还要更新另一张表（比如扣库存 + 写订单）
- 业务逻辑要求“全成功或全失败”，且这批数据之间有强一致性依赖
Excel 导入、日志归档、后台数据补全这类操作，跳过事务更安全、更快。
重复主键或唯一索引报错怎么绕开
insertAll() 默认不跳过冲突，遇到重复会直接中断并抛出 SQLSTATE[23000]: Integrity constraint violation: 1062 Duplicate entry。
想跳过重复行，不能靠参数开关，得换写法：
- 用
replaceInto()：写法是Db::name('user')->replace()->insertAll($data)，但它本质是先DELETE再INSERT，可能触发外键级联或重置自增 ID - 要“存在则更新、不存在则插入”，得拼原生 SQL：
INSERT INTO user (...) VALUES (...) ON DUPLICATE KEY UPDATE ...，然后用Db::execute() - 想忽略冲突继续插？只能自己预查主键/唯一字段是否存在，或改用
LOAD DATA INFILE（需服务器权限支持）
为什么用了 insertAll 还慢得像卡住
大概率不是数据库问题，是 PHP 层在拖后腿：
- 开发环境开着
app_debug = true和日志记录？每条insertAll()都会把完整 SQL 和参数刷进日志文件，磁盘 IO 直接拉满。线上没问题，但本地跑 1w 条就卡死——先关日志 - 用了
saveAll()代替insertAll()？它会遍历触发验证、事件、自动时间戳、类型转换……1000 条可能慢 3–5 倍 - 字段名没对齐数据库列名，又没配
field映射？ThinkPHP 6 默认过滤非法字段，TP5.1 直接报错，TP6 则静默丢弃，看着像“插了但查不到” - Web 请求里硬塞 1w 条？Nginx 默认 30 秒超时，得改用队列，或 CLI 下跑并设
set_time_limit(0)
真正卡点往往藏在日志、模型层冗余逻辑、或字段映射失配里，而不是 SQL 本身。
