LaravelEloquentTouch更新父级时间戳技巧

Laravel Eloquent 的 `touch()` 级联更新父级时间戳功能看似简单却极易失效——真正关键的不是子模型声明 `belongsTo()`，而是必须在**父模型中显式配置 `protected $touches = ['关联方法名']`**，且该名称需与父模型内定义的 `belongsTo()` 或 `hasOne()` 关联方法名（如 `user()`）完全一致、大小写敏感；同时父模型必须启用时间戳（`$timestamps = true`）并确保数据库字段存在且类型正确（DATETIME/TIMESTAMP），否则会静默失败。更需注意：`save()`、`update()`、`delete()` 会自动触发级联 touch，但 `create()` 不会；`touch()` 只更新 `updated_at`（或自定义的 `$updatedAt` 字段），绝不影响 `created_at`，调试时只需三步排查：父模型有无 `$touches` 数组、关联名是否精确匹配、时间戳是否启用且字段可用——掌握这些，就能让父子模型的时间同步真正可靠运行。

为什么 touch() 不生效：父模型没定义关联关系

直接调用 $child->touch() 不会自动更新父级时间戳，除非你在子模型里显式声明了父关联，并在父模型中启用 touches。Eloquent 的级联 touch 是单向、声明式的，不是自动推断的。

常见错误是只在子模型写 belongsTo()，却忘了在父模型加 touches 数组：

// Post.php（父模型）
class Post extends Model
{
    protected $touches = ['user']; // 必须写这里，不是子模型里
}

• $touches 数组里的键必须和父模型中定义的关联方法名完全一致（比如 user() → 写 'user'）
• 关联方法返回值必须是 belongsTo() 或 hasOne()，hasMany() 不支持
• 如果关联名是 author()，数组就得写 ['author']，拼错或大小写不一致都会静默失效

什么时候触发 touch()：不只是 save()，还有这些场景

touch() 级联只在父模型被“触碰”时才发生，而触发方式不止手动调用 —— 实际上更常用的是隐式触发：

• 子模型调用 save()、update()、delete() 时，只要它所属的父模型启用了 touches，就会自动 touch 父模型
• 父模型自身调用 touch()，也会递归触碰它所声明的关联（前提是关联模型也设置了 $touches）
• 但 create() 静态方法不会触发父级 touch —— 因为记录还没关联好，Eloquent 还没机会检查 $touches

所以别指望 Post::create([...]) 会自动 touch user；得先存 post，再显式 $post->touch()，或改用 save() 流程。

touch() 和 timestamps 的兼容性细节

父模型必须启用时间戳，否则 touch() 什么也不做。但要注意字段名和配置差异：

• 默认更新 updated_at，但如果你改过 $updatedAt，比如设成 'modified_at'，那 touch() 只会更新这个自定义字段
• $touches 不影响 created_at —— 它只负责更新“最后修改时间”，哪怕你 touch 的是刚创建的记录
• 如果父模型禁用了时间戳（public $timestamps = false），$touches 彻底失效，无警告
• 数据库字段类型要是 DATETIME 或 TIMESTAMP，用 INT 存时间戳会导致 touch() 写入 0

调试 touch() 失效的三个检查点

级联 touch 出问题，90% 是卡在这三处，按顺序查比翻文档快：

• 父模型类里有没有 protected $touches = [...]？注意不是子模型，也不是控制器里
• 数组里的字符串是否和父模型中某个关联方法名（比如 user()）严格一致？包括下划线/驼峰
• 父模型的 $timestamps 是不是 true？且对应字段在数据库中存在、可写？

别在子模型里加 $touches 试图反向控制父模型 —— Eloquent 不支持这种反向声明。级联方向是固定的：子变更 → 触发父 touch，不是反过来。

到这里，我们也就讲完了《LaravelEloquentTouch更新父级时间戳技巧》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！