touch()不生效是因为父模型未定义$touches数组,且必须与关联方法名严格一致、父模型启用时间戳;仅子模型声明belongsTo()不够,需在父模型中配置protected $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() 流程。
立即学习“PHP免费学习笔记(深入)”;
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,不是反过来。



















