ThinkPHP6批量添加失败主因是字段映射错误、事务缺失、内存超限及验证绕过；需严格校验字段名与模型定义一致，包裹Db::transaction，分批处理并前置唯一性校验。
检查数据格式与字段映射是否严格匹配
模型层的 saveAll() 对字段名极其敏感：数据库字段是 user_id，但你传的是 ['uid' => 123]，TP 就会当成新记录插入（或直接跳过主键校验）；若模型中声明了 protected $pk = 'id'，那每条数据里必须带 'id' 键，否则默认走 INSERT，且可能因唯一约束报错。
- 用
array_keys($data[0])打印首条数据字段，和数据库表结构逐列比对 - 确认模型中
$schema或数据库实际字段名一致，尤其注意下划线/驼峰风格 - 联合主键场景（如
order_id + sku_id）不能靠模型自动识别，需手动预检重复
事务没包住或中途异常未捕获
批量写入默认不开启事务，部分成功、部分失败是常态。比如插 500 条，第 301 条因手机号重复报错，前 300 条已落库，后 199 条丢弃——这绝不是“失败”，而是数据不一致。
- 必须用
Db::transaction(function () use ($data) { ... })包裹整个操作 - 别在事务里混用
saveAll()和Db::insertAll()，它们底层连接可能不同，事务失效 - catch 异常后，不要只返回“失败”，要记录具体哪条数据、哪个字段触发了错误（例如用
Log::error('saveAll fail at index 227: ' . json_encode($data[227]))）
内存溢出或超时导致中断
一次性传几千条数据进 saveAll()，PHP 内存暴涨、CLI 脚本被回收、Web 请求被 Nginx 断连，表面看是“失败”，实则是环境限制。
- 按
array_chunk($data, 400)拆成每批 400 条以内（200–500 是实测平衡点） - CLI 脚本开头加
set_time_limit(0)，Web 接口改用队列（如 think-queue）异步处理 - 每批执行完调用
gc_collect_cycles()主动回收内存，防止持续上涨 - 避免循环中反复 new 模型实例，复用一个对象：
$user = new User(); $user->saveAll($chunk);
验证与去重逻辑被绕过
很多人以为加了 validate(true) 就万事大吉，但 TP6 的验证规则（如 unique）在 saveAll() 中不会自动触发数据库查重，它只做格式、必填等内存级校验。
立即学习“PHP免费学习笔记（深入）”；
- 唯一性校验必须前置：提取所有待插数据的校验字段（如邮箱数组），用
Db::name('user')->where('email', 'in', $emails)->select()查库比对 - 对联合唯一字段（如
[user_id, action]），把每组值转为字符串键（"{$item['user_id']}-{$item['action']}"），再集合比对 - 校验失败要返回具体行号和冲突字段，方便前端标红提示，而不是笼统说“存在重复”
