insertall 失败主因有四：一是数组键名非数字连续索引导致直接返回 false；二是字段缓存未更新致新增字段被静默丢弃；三是主键或唯一索引冲突使整批中断；四是事务中未捕获异常致后续操作仍执行。
insertAll 失败不是“没反应”，而是常在你没看见的地方直接返回 false 或抛异常——多数情况根本没走到数据库，连 SQL 都没生成。
数组键名非数字连续索引导致 insertAll 直接返回 false
ThinkPHP 的 insertAll 内部会检查 $data[0] 是否为数组。如果传入的是关联键（如时间戳、UUID、字符串 ID），或键不连续（[2] => [...], [5] => [...]），就会跳过校验直接返回 false。
- 常见场景：从 Redis 或 API 拉取数据后未重排下标；用
array_merge($a, $b)合并后丢失数字索引 - 验证方式：打印
array_keys($data)，看是否为[0, 1, 2, ...] - 修复方法：插入前强制重置键名：
$data = array_values($data)
字段缓存未更新，新增字段被静默丢弃
表结构加了新字段（比如 is_reviewed），但 runtime/Data/_fields/ 下的缓存仍是旧结构，insertAll 就会过滤掉该字段——不报错、不提示，只少写。
- TP5/6 默认开启
DB_FIELDS_CACHE，缓存文件按表名哈希生成，修改字段后必须清缓存 - 不要只删
runtime/cache，重点清runtime/Data/_fields/全部 PHP 文件 - 开发阶段建议配置中设
'DB_FIELDS_CACHE' => false，避免反复踩坑
主键或唯一索引冲突导致整批中断
insertAll 底层是普通 INSERT INTO ... VALUES (), ()，不带 IGNORE 或 ON DUPLICATE KEY UPDATE。只要其中一条记录触发主键/唯一键重复，整个批次立刻失败，返回值是 false 或抛出 DataNotFoundException。
- 错误信息典型为：
SQLSTATE[23000]: Integrity constraint violation: 1062 Duplicate entry - 不会“跳过冲突行”，也不会告诉你哪一行冲突——需先查库确认目标数据是否存在
- 若需容错，改用原生 SQL：
Db::execute('INSERT IGNORE INTO ...')，或分批 + 单条 try/catch
事务中未捕获异常，后续操作仍执行
insertAll 在事务里失败时默认抛异常，但脚本不会自动终止。如果你没 try/catch，后面 updateAll 或 commit 照常运行，造成数据不一致。
- 返回值是影响行数（int），不是布尔值；
if ($res)判定不可靠（0 行也可能是成功删除） - 务必显式包裹事务：
Db::startTrans(); try { ... insertAll ... updateAll ... Db::commit(); } catch (\Exception $e) { Db::rollback(); throw $e; } - 大批量时建议分片（如每 200 条一批），降低单次失败影响范围
最容易被忽略的是：insertAll 对输入数组结构极度敏感，且字段合法性检查发生在 SQL 执行前——它甚至不依赖数据库连接是否正常。别急着查 MySQL 日志，先盯住你的 $data 数组和 runtime/Data/_fields/ 缓存。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
