ThinkPHP 的 update 方法不支持直接传入 where 条件参数，必须通过链式 where() 预设条件后再调用 update()，否则会全表更新；返回值为布尔型，需结合 rowCount() 或额外查询确认实际影响行数。
ThinkPHP 的 update 方法不接受 where 条件直接传参
ThinkPHP 6.x 和 5.x 的 update 方法（如 Db::table()->update() 或模型的 save()）本身不支持把 where 条件当参数塞进去——你写 update($data, $where) 会报错或静默失败。这是新手最常卡住的地方，以为和原生 SQL 的 UPDATE ... WHERE 一样直给。
真正安全更新特定记录，得靠「先查后改」或「链式条件 + update」两条路，但后者才是防误操作的核心。
-
Db::name('user')->where('id', 123)->update(['status' => 1])是正确姿势；update()调用前必须已绑定where - 模型调用同理：
UserModel::where('id', 123)->update(['status' => 1])，不能(new UserModel())->update($data, $where) - 如果硬要用
save()，必须先find()加载实例再改字段，否则会全表覆盖主键以外字段（尤其危险！）
为什么不用 where + update 链式调用就容易误更新
漏掉 where 或条件为空时，ThinkPHP 默认行为是：没 where 就更新整张表。比如 Db::name('order')->update(['paid' => 1])，若没显式加 where，所有订单瞬间被标为已支付。
这不是 Bug，是设计使然——ThinkPHP 把 update() 当作「对当前查询结果集执行更新」，而空查询结果集默认就是全表。
立即学习“PHP免费学习笔记（深入）”；
- 调试时可加
->getLastSql()看生成的 SQL，确认是否带WHERE - 生产环境务必在
update前检查where参数是否有效，例如if (empty($id)) { throw new Exception('ID missing'); } - 避免用用户输入直接拼
where，优先用参数绑定：->where('uid', $uid)，别写->where("uid = $uid")
update 返回值不是影响行数，而是「成功/失败」布尔值
很多人靠 if (Db::name()->where(...)->update(...)) 判断是否更新了数据，但这个 true 只代表 SQL 执行成功，不代表有记录被改——哪怕 WHERE id = 999999 没匹配到任何行，返回仍是 true。
要确认是否真改到了，得用 ->execute() 或查影响行数：
-
$res = Db::name('user')->where('id', $id)->update($data);→$res是布尔值 - 换用
$rows = Db::name('user')->where('id', $id)->update($data) ?: 0;不行，还是布尔 - 正确方式：
$rows = Db::name('user')->where('id', $id)->update($data) ? Db::getPdo()->rowCount() : 0; - 更稳做法：先
count()再更新，或更新后select验证字段值
批量更新带条件时，where 必须明确且不可省略
批量更新（比如改一批订单状态）最容易翻车。你以为 update([['id'=>1,'status'=>2], ['id'=>2,'status'=>2]]) 会按 id 更新对应行？错。ThinkPHP 的批量更新只支持单字段统一赋值，不支持每行不同条件。
真要按不同 id 改不同值，要么循环单条更新（加事务），要么用原生 SQL 或 query()：
- 循环方式：
Db::startTrans(); foreach ($list as $item) { Db::name('order')->where('id', $item['id'])->update(['status' => $item['status']]); } Db::commit(); - 原生 SQL：
Db::execute("UPDATE order SET status = CASE id WHEN 1 THEN 2 WHEN 2 THEN 2 END WHERE id IN (1,2)") - 千万别把数组直接丢给
update()期望它自动拆条件——它只会当成一条记录插入或覆盖
复杂条件更新，宁可多写几行，也别赌框架的“智能推断”。ThinkPHP 的 where 是开关，不是装饰。
