ThinkPHP 8.0 批量添加报“字段不匹配”错，本质是数据键名与数据库表字段不一致；需确保 $data 中每项键均存在且统一，可用 Db::getFields() 校验、array_map 预处理补全，或通过模型 $schema 过滤。
ThinkPHP 8.0 批量添加数据时出现“字段不匹配”报错，本质是 数据库表字段与传入数据键名不一致，或存在非法字段、缺失必需字段、类型不兼容等情况。核心不是语法写错，而是数据结构没对齐表结构。
检查数据数组的键是否全部存在于数据表中
TP8 默认开启严格模式，Db::table('user')->insertAll($data) 要求每个数组元素的键（即字段名）必须是数据库表中存在的字段，多一个、少一个、拼错一个都会报错。
- 用
Db::getFields('user')获取当前表所有合法字段名，对比你传入的 $data 数组的 key - 特别注意：TP8 不会自动忽略多余字段，也不会补全默认值（除非字段设了 DEFAULT 或允许 NULL）
- 常见陷阱：前端传了
create_time，但表里实际是created_at；或误传了id（自增主键）导致冲突
确保每条记录的字段结构完全一致
批量插入要求所有子数组具有相同键集合。不能有的带 status，有的没这个键；也不能有的用 is_deleted，有的用 deleted。
- 统一用
array_map预处理数据，补全缺失字段（如设为 null 或默认值） - 示例：
$fixed = array_map(fn($item) => array_merge(['status' => 1, 'sort' => 0], $item), $rawData); - 避免混用关联数组和索引数组——
insertAll只接受关联数组组成的二维数组
关闭字段检测（仅调试/特殊场景）
如果确认数据安全且需绕过校验（比如动态字段、JSON 存储等），可临时禁用字段检查：
立即学习“PHP免费学习笔记（深入）”；
- 在插入前设置：
Db::setStrict(false); - 或使用原生 SQL：
Db::execute('INSERT INTO user (name,email) VALUES (?,?),(?,?)', [...]); - ⚠️ 注意：关闭 strict 后，非法字段会被静默丢弃，可能导致数据丢失，生产环境慎用
利用模型自动过滤（推荐长期方案）
若使用 Model，可通过 protected $filter 或 protected $schema 显式声明允许字段，再调用 UserModel::insertAll()，模型会自动过滤非法字段并补全默认值。
- 在模型中定义：
protected $schema = ['id' => 'int', 'name' => 'string', 'email' => 'string']; - 配合
protected $type = ['create_time' => 'datetime'];处理时间自动转换 - 插入前还可加钩子：
protected static function init(): void { static::saving(...); }统一处理字段
