ThinkPHP批量插入报错主因是数据结构与表结构未对齐。需确保每行字段名真实存在、大小写一致、数量相同，并用Db::getFields()校验；统一补全、过滤、重置索引；模型层推荐用$schema+insertAll()自动保护。
ThinkPHP批量插入报“字段不匹配”或“列数不对”，核心不是SQL写错了，而是数据结构和数据库表结构没对齐。TP默认严格校验字段名、数量、顺序，任何偏差都会直接中断并报错。
检查每条数据的键名是否全部合法
TP8/6/5都要求 $data 中每个子数组的键（字段名）必须是数据库表中真实存在的字段，且大小写完全一致。多一个、少一个、拼错一个、大小写不符，都会触发“Unknown column”或“字段不匹配”。
- 用 Db::getFields('table_name') 获取当前表所有字段名，再对比 array_keys($data[0])
- 特别注意：前端常传
create_time，但表里可能是created_at；user_id和userId在 Linux MySQL 下视为不同字段 - 别依赖
array_change_key_case()自动转小写——它会破坏真实字段名，导致写入失败
确保所有行字段数量和键名完全一致
insertAll 要求二维数组中每一行的键集合必须一模一样。不能有的带 status，有的没有；也不能有的用 is_deleted，有的用 deleted。否则会报 SQLSTATE[21S01]（列数不匹配）。
- 用 array_map('count', $data) 快速检查每行字段数是否全等
- 统一用模板初始化：array_fill_keys(['name', 'email', 'status'], null)，再逐条赋值
- 避免从
$_POST或 JSON 直接取值后拼数组——中间可能丢键、混入额外字段（如full_name、user.name）
预处理数据：补全、过滤、重置索引
原始数据往往不规整，需在插入前做标准化处理，而不是指望框架自动兼容。
立即学习“PHP免费学习笔记（深入）”；
- 重置外层数组键名：$data = array_values($data)，确保是连续数字索引（否则 insertAll 可能静默失败）
- 补全缺失字段：array_map(fn($item) => array_merge(['status' => 1, 'sort' => 0], $item), $data)
- 过滤非法字段：array_map(fn($item) => array_intersect_key($item, array_flip(['name', 'email', 'status'])), $data)
模型层推荐做法：用 $schema + insertAll()
如果使用模型（如 UserModel），比 Db 更安全可控。定义 $schema 后，insertAll() 会自动过滤非法字段、补默认值、转换类型。
- 在模型中声明：protected $schema = ['id' => 'int', 'name' => 'string', 'email' => 'string', 'created_at' => 'datetime'];
- 调用：UserModel::insertAll($data) —— 不触发 save 流程，但享受字段白名单保护
- 时间字段可配合
createTime自动填充，但批量时建议手动赋值更可靠
