CodeIgniter的update_batch()仅支持单字段主键匹配更新，忽略链式where条件，字段名错误或缺失匹配字段会导致静默失败；复杂条件需用原生INSERT...ON DUPLICATE KEY UPDATE或CI4事务循环更新。
$this->db->update_batch() 是 CodeIgniter 2/3 中最直接的批量更新方式，但它有硬性限制：**必须按主键（或唯一键）字段匹配更新，且所有记录共用同一组 WHERE 条件字段**。它不支持每条记录带不同 WHERE 条件（比如每条数据要按不同 id 或不同 product_id/color_id 组合更新），这点很多人踩坑后才发现。
为什么 update_batch() 有时“没生效”或“全表乱更新”
常见错误现象是：传入的数据数组里字段名和数据库列名不一致、缺少关键匹配字段、或误以为能靠 where 链式调用控制范围——但 update_batch() **完全忽略之前调用的 $this->db->where()**。
- 它只认你传入的二维数组中「作为匹配依据」的那个字段（默认是
id），并自动生成类似WHERE id IN (1,2,3)的条件 - 如果你的数据里没有
id字段，它会用第一个字段当主键字段，极易错配 - 如果传入的数组中某条记录缺失该字段，那条就根本不会被更新（静默跳过）
- 它不校验字段是否存在，字段名拼错只会导致对应列被设为
NULL或默认值
想按不同条件批量更新？别硬套 update_batch()
比如你有一组 product_color 关系数据，要按 pro_id 和 color_id 联合更新 status，这时 update_batch() 无能为力——它只支持单字段匹配。
可行做法是手写原生 SQL + INSERT ... ON DUPLICATE KEY UPDATE（MySQL）或分批调用模型 update()：
- 确保
(pro_id, color_id)是联合唯一索引（否则ON DUPLICATE不触发） - 构造带
VALUES列表的语句，例如：INSERT INTO product_color (pro_id,color_id,status) VALUES (1,5,'active'),(1,7,'inactive') ON DUPLICATE KEY UPDATE status=VALUES(status) - CodeIgniter 2/3 不内置该语法支持，需用
$this->db->query()执行；CI4 可通过 Query Builder 拼接或直接执行原生语句
CI4 中更稳妥的批量更新路径
CI4 废弃了旧版 update_batch()，官方推荐走 Model 层 + 显式循环，看似“慢”，实则可控、可加事务、可捕获单条失败：
- 用
$model->update($id, $data)是最安全的单条更新方式，$id必须明确传入 - 批量场景下，封装成事务块：
$this->db->transStart(); foreach ($items as $item) { $model->update($item['id'], $item['data']); } $this->db->transComplete(); - 若性能敏感且数据量大（如 >500 行），再考虑原生
INSERT ... ON DUPLICATE KEY UPDATE或分批次（如每次 100 条）调用update()
真正容易被忽略的一点：**批量更新前，必须确认目标字段有合适的唯一约束（主键或唯一索引）**。没有它，ON DUPLICATE KEY UPDATE 失效，update_batch() 匹配失效，连“部分更新失败”的提示都不会有——它就 quietly 跳过。
