ThinkPHP 的 saveAll 批量更新需用 allowField() 限定字段白名单，确保主键名与模型定义一致，并根据性能和业务需求选择 saveAll 或 Db::update()。
ThinkPHP 的 saveAll 批量更新默认会把每条数据中所有非空字段都写入数据库，容易误改不需要变动的列。要只更新指定字段，核心是用 allowField() 明确限定白名单，同时确保数据结构和主键传递正确。
用 allowField() 锁定可更新字段
这是最直接、最安全的方式。调用 saveAll 前链式调用 allowField(['字段1', '字段2'])，框架只会将数组中声明的字段纳入 SQL 的 SET 子句，其余字段（包括模型里已存在的其他属性）全部忽略。
- 即使数据里带了
password、created_at等字段，只要没列在allowField中，就不会进 SQL - 对批量数据中的每一条记录都生效，规则统一
- 配合模型的自动时间戳时，若不想更新
update_time，需额外处理：要么关掉自动写入，要么显式传入'update_time' => null并包含在allowField里
确保每条数据含正确主键
saveAll 判断更新还是新增，只看数据中是否含有模型定义的主键字段（如 id），且字段名必须完全一致。
- 如果数据库主键是
user_id，但模型里写的是protected $pk = 'id'，那么传['user_id' => 1]会被当成新增 - 前端传来的字段名不匹配时，手动重命名：例如
array_map(fn($d) => ['id' => $d['user_id'], 'status' => $d['status']], $data) - 不能依赖自动转换，字段名错一个字母就变成全量插入
避免踩坑的实操建议
大批量场景下，saveAll 本质仍是循环单条执行，性能有限。若只是同字段、同条件批量更新，更推荐原生 Db::table()->where()->update()。
立即学习“PHP免费学习笔记（深入）”；
- 用
whereIn('id', $ids)而不是拼字符串，防 SQL 注入 - 绝对不要省略
where()，否则update()会全表覆盖 - 数据量超 500 条时，考虑分块（如
array_chunk($data, 100)）再调saveAll，减少单次事务压力 - 需要验证或触发事件时才用
saveAll；纯字段更新追求速度，选Db::update()
关键不在“怎么批量”，而在“怎么精准控制字段”。allowField() 是明确意图的起点，主键对齐是执行前提，方法选择则取决于业务约束和性能要求。
