ThinkPHP6.0批量插入数据_ThinkPHP6.0批量插入操作指南【数据库】

直接用 Db::insertAll()，别绕弯子。它不是语法糖，是真正走预处理 + 单条多值 SQL 的批量写入，性能碾压循环 insert() 或 sa veAll()。

单次插多少条才不翻车

不能看别人说“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() 反而延长锁持有时间，高并发下容易引发锁等待甚至超时。

只在以下两种情况才必须加事务：

• 插入这批数据的同时，还要更新另一张表（比如扣库存 + 写订单）
• 业务逻辑要求“全成功或全失败”，且这批数据之间有强一致性依赖

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 条就卡死——先关日志
• 用了 sa veAll() 代替 insertAll()？它会遍历触发验证、事件、自动时间戳、类型转换……1000 条可能慢 3–5 倍
• 字段名没对齐数据库列名，又没配 field 映射？ThinkPHP 6 默认过滤非法字段，TP5.1 直接报错，TP6 则静默丢弃，看着像“插了但查不到”
• Web 请求里硬塞 1w 条？Nginx 默认 30 秒超时，得改用队列，或 CLI 下跑并设 set_time_limit(0)

真正卡点往往藏在日志、模型层冗余逻辑、或字段映射失配里，而不是 SQL 本身。