insertAll失败主因是数组键非数字索引、字段缓存未更新、主键冲突、事务未捕获异常；需用array_values重置键、清_fields缓存、分片插入、显式事务控制。
insertAll 传入数组下标不是从 0 开始，直接返回 false
这是最隐蔽也最高频的失败原因：ThinkPHP 的 insertAll 内部会检查 $data[0] 是否为数组，如果不是（比如你用时间戳、UUID 或自定义字符串作键），就立刻返回 false，不报错也不提示。
常见表现：$res = $model->insertAll($data) 返回 false，但没任何异常，日志里也看不到 SQL。
- 用
array_values($data)重置键名，确保是连续数字索引 - 别依赖前端或业务逻辑传来的「带名键」数组，入库前统一做转换
- 加一行调试：
dump(array_keys($data));看是不是[0,1,2]而不是['1698765432','1698765433']
字段缓存未更新，新字段被静默丢弃
数据库加了字段，模型却写不进去？大概率是 runtime/Data/_fields/ 下的缓存没刷新。TP 默认开启字段缓存，结构变更后不会自动感知。
现象：INSERT INTO user (name, email) —— 新增的 status 字段完全没出现在 SQL 里，也不报错。
立即学习“PHP免费学习笔记（深入）”；
- 开发阶段建议在配置中设
'DB_FIELDS_CACHE' => false - 上线后改表结构，必须手动删掉
runtime/Data/_fields/全部文件 - Linux 环境注意
runtime目录权限：PHP 需要write + execute权限才能进入子目录生成缓存
主键或唯一索引冲突导致整批中断
insertAll 底层是普通 INSERT INTO ... VALUES (),()，不带 INSERT IGNORE 或 ON DUPLICATE KEY UPDATE。只要有一条数据主键重复，整个批次就抛出 Integrity constraint violation 异常并终止。
错误信息典型长这样：SQLSTATE[23000]: Integrity constraint violation: 1062 Duplicate entry '1001' for key 'PRIMARY'
- 想跳过冲突行 → 改用
Db::execute('INSERT IGNORE INTO ...')拼原生 SQL - 想存在则更新、不存在则插入 → 用
replaceInto()，但注意它会先DELETE再INSERT，可能影响外键或自增 ID - 大批量时务必分片：
$model->insertAll($data, 500)控制单次不超过 500 条，防 MySQL packet size 超限
事务中没捕获异常，部分操作仍执行
insertAll 失败时抛异常，但如果你没 try/catch，事务不会自动回滚。后续的 updateAll 或其他 DB 操作照常执行，造成数据不一致。
返回值不可靠：insertAll 成功返回影响行数（int），失败抛异常——但 PDO 在非严格模式下可能只返回 0 而不报错。
- 必须显式包裹事务：
Db::startTrans(); try { ... insertAll ... updateAll ... Db::commit(); } catch (\Exception $e) { Db::rollback(); throw $e; } - 别用
if ($res)判断成功，要用if ($res !== false)，因为成功时返回的是正整数，不是true - 开启
'DB_DEBUG' => true，盯紧日志里实际执行的 SQL 和错误堆栈
