如何使用ThinkPHP Model的isUpdate方法精确控制数据新增或更新操作？

本文共计907个文字，预计阅读时间需要4分钟。

ThinkPHP的`save()`方法默认基于数据模型实例状态判断操作类型，`isUpdate()`方法仅表示建议，并非强制开启——除非你显式调用它并配合正确的上下文。

常见失效场景：

• 模型已从数据库查出（比如 User::get(1)），再调用 isUpdate(true) + save()，系统仍可能按“更新”走，但若字段值没变，update_time 就不会刷新（这不是 bug，是设计）
• 手动 new 模型后调用 isUpdate(true)，但没传主键或主键字段不在数据中，底层无法拼 WHERE 条件，最终退化为 INSERT
• 使用 saveAll() 时调用 isUpdate() 无效——该方法不走单条模型的 isUpdate 判断逻辑

isUpdate(false) 强制新增的典型用法

当你明确知道要插入新记录，但模型对象已经带了主键（比如从表单提交了 id 字段），又不想被误判为更新，就得用 isUpdate(false)。

实操要点：

立即学习“PHP免费学习笔记（深入）”；

• $user = new User(['id' => 123, 'name' => 'test']); $user->isUpdate(false)->save(); → 忽略 id，强制 INSERT
• 如果模型开启了自动写入时间戳（$autoWriteTimestamp = 'int'），createTime 会写入，updateTime 不会触发
• 注意：若数据库主键是自增，而你传了 id 且该值已存在，会直接报 Duplicate entry 错误，不是静默覆盖

什么时候必须用 isUpdate 而不是靠自动识别

自动识别规则简单粗暴：new 出来就是新增，get 出来就是更新。但现实业务常打破这个假设。

典型需干预的场景：

• 后台导入 Excel 数据，每条含主键，想“有则更新、无则新增”——此时应统一用 User::update($data) 静态方法，而非 isUpdate()
• 模型继承自公共基类，构造时已预设部分字段（含主键），但业务语义仍是新增——必须显式 isUpdate(false)
• 使用软删除模型，get() 查到的是已软删记录，你想对它“真正新增一条”，就得 isUpdate(false) 避免触发 restore 逻辑

isUpdate 与静态 update 方法的本质区别

isUpdate() 是实例方法，作用于单个模型对象；User::update() 是静态方法，绕过模型实例生命周期，直接走查询构造器。

关键差异：

• $user->isUpdate(true)->save()：走模型事件（before_update、after_update）、修改器（accessor/mutator）、自动完成（auto）、时间戳写入
• User::update(['name' => 'x'], ['id' => 1])：不触发模型事件，不走修改器，但支持数组/闭包条件，性能略高
• 时间戳行为不同：前者只有字段值真变化才更新 updateTime；后者只要执行了 SQL UPDATE，就强制刷 updateTime（前提是模型配置了 $updateTime）

复杂业务里，别只盯着 isUpdate 打转——该用静态 update 就用，该拆成先查后 save 就拆，模型的“智能识别”只是默认捷径，不是银弹。