CodeIgniter 原生不支持 UPDATE ... WHERE IN，须用 update_batch() 或正确循环调用 where()+update()；常见错误是 where() 未重置、键不连续、allowedFields 未配置、事务与分块缺失。
CodeIgniter 原生不支持 SQL 的 UPDATE ... WHERE IN 批量更新语法，必须用 update_batch() 或手动循环 + where() + update()，否则会误更新整张表或静默失败。
为什么直接 foreach + update() 会失效或只更新一行？
常见错误是把 where() 和 update() 写在循环外，或者没重置查询条件。CodeIgniter 的 Query Builder 是链式累积的 —— 上一次 where() 不显式清除，下次 update() 仍会沿用。
- 错误写法：
$this->db->where('id', $id[$x]); $this->db->update(...)放在循环里看似没问题，但若中间有其他 DB 操作（如日志写入、事务判断），where可能被污染 - 更隐蔽的问题：数组键不连续（比如前端删过某条记录导致
$id = [0 => 1, 2 => 3]），for($x=0; $x 会越界或跳过 -
update()返回布尔值，但很多人没检查if (!$this->db->update(...)) { log_message('error', $this->db->error()); }，导致失败也不报错
update_batch() 的数组结构必须严格对齐
这是最常踩的坑：update_batch() 要求每个子数组的键名完全一致，且必须包含用于匹配的「关键字段」（第三个参数），否则会插入新行或报错。
- 正确结构示例：
$batch = [['id' => 1, 'name' => 'A', 'qty' => 10], ['id' => 2, 'name' => 'B', 'qty' => 20]];，调用时写$this->db->update_batch('table', $batch, 'id') - 错误结构：
['id'=>1,'name'=>'A']和['id'=>2,'qty'=>20]混用 → 第二条因缺name字段被设为NULL（如果字段允许）或触发数据库 NOT NULL 报错 - 关键字段（如
'id'）必须是数据库中真实存在的列，且类型要匹配（不能传字符串 ID 去匹配 INT 主键）
批量更新前必须确认 allowedFields 白名单
CodeIgniter 4 默认开启字段白名单机制，模型的 $allowedFields 数组若没包含你要更新的字段，那些字段会被直接过滤掉，update_batch() 也受此限制 —— 这是静默失败的主因之一。
- 检查模型定义：
protected $allowedFields = ['id', 'item_desc', 'item_qty', 'price', 'total']; - 如果用的是 CI3，该机制不存在，但 CI4 中漏配会导致所有批量字段更新无效
- 临时绕过（不推荐）：
$this->model->skipValidation()->update_batch(...)，但仅用于调试，上线前必须补全allowedFields
大数量更新时性能与事务控制要点
超过 500 条数据时，update_batch() 会生成一条超长 SQL（含多个 VALUES），可能触发 MySQL max_allowed_packet 限制或锁表时间过长。
- 分块处理建议：
array_chunk($data, 100)拆成每批 100 条，再循环调用update_batch() - 务必包裹事务：
$this->db->transBegin();→ 批量更新 →if ($this->db->transStatus() === false) { $this->db->transRollback(); }，避免部分成功部分失败 - 注意：CI3 的
update_batch()不支持IGNORE，如需跳过冲突行（如唯一键重复），得改用原生 SQL 或拆成单条带INSERT ... ON DUPLICATE KEY UPDATE
真正容易被忽略的是：CI4 模型层的 $useTimestamps 和 $updatedField 会在每次 update_batch() 时自动覆盖所有行的更新时间 —— 如果你依赖这个字段做业务判断（比如“只更新 24 小时内创建的记录”），它反而会成为干扰项。
