Laravel多态关联中ID字段应存储哪种类型？

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

commentable_id 存储的是被关联模型的键值（通常是 id），而不是自增序号、UUID（除非你选择的主键就是 UUID）或评论自身的 ID。

为什么必须是目标模型的主键？

多态关联靠 commentable_id + commentable_type 一起定位唯一记录。Eloquent 在查询时会用这两个字段拼出类似 WHERE commentable_id = ? AND commentable_type = ? 的条件，再根据 commentable_type 自动实例化对应模型（比如 App\Models\Post），最后调用该模型的主键字段去匹配 —— 所以这个 ID 必须和目标模型声明的 $primaryKey 一致。

• 如果 Post 模型设了 protected $primaryKey = 'slug'，那 commentable_id 就得存 slug 值，且 commentable_type 得对应指向该模型
• 如果 Video 主键是 video_uuid，但没重写 $primaryKey，Eloquent 仍默认按 id 查，会导致查不到数据
• 迁移里用 $table->morphs('commentable') 生成的 commentable_id 是 unsignedBigInteger，不兼容 UUID 主键，此时必须手动定义字段类型

常见错误：ID 存了错的值

最典型的误操作是把评论自己的 id 或其他无关数字塞进 commentable_id，结果查 $comment->commentable 返回 null。

• 现象：$comment->commentable 始终为 null，但数据库里 commentable_type 明明是对的
• 检查点：确认该 commentable_id 值是否真实存在于对应模型表中（比如 commentable_type = 'App\Models\Post' 时，commentable_id = 123 是否在 posts 表里有 id = 123 的记录）
• 调试技巧：直接执行 SQL SELECT * FROM posts WHERE id = 123 验证，别只看 Eloquent 查询日志

批量插入或手动赋值时怎么保证 ID 正确？

用模型关系方法（如 $post->comments()->save($comment)）能自动填对 commentable_id 和 commentable_type；但若绕过关系、直接 new Comment 再 save，就得自己设：

• 正确：$comment->commentable_id = $post->id; $comment->commentable_type = $post->getMorphClass(); $comment->save();
• 危险：$comment->commentable_id = $post->id; $comment->commentable_type = 'App\Models\Post'; —— 如果模型用了别名或命名空间变更，硬编码字符串会失效
• 更稳：$comment->commentable()->associate($post)->save();，它内部会调用 getMorphClass() 并校验模型状态

真正容易被忽略的点是：commentable_id 的语义完全依赖于 commentable_type 的准确性。两者必须同步更新，缺一不可；删父模型时，如果没配软删除或事件监听，commentable_id 变成悬空引用，查出来就是 null，但数据库不会报错。