多态关联需严格遵循约定：comments表必须有commentable_id和commentable_type字段，Comment模型用morphTo()，被关联方用morphMany()并建议配置morphMap，查询需用->with('comments.commentable')预加载。
多态关联在 Laravel 中不是“配置出来”的，而是靠约定 + 正确建模实现的；用错字段名或漏掉 morphMap，查不到数据、报 Class not found 都是常态。
多态关联必须有这三张表字段
Laravel 的多态关联依赖固定字段结构，缺一不可。比如评论（comments）要能挂在文章（posts）或视频（videos）下：
-
comments表必须包含：commentable_id（目标记录 ID）和commentable_type（目标模型类名，如App\Models\Post） - 字段名不能自定义为
target_id/target_type—— 除非显式指定，否则 Laravel 只认{name}_id+{name}_type - 如果用了短类名（如
Post），又没配morphMap，Laravel 会尝试加载Post这个类，而不是App\Models\Post，直接报错
Comment 模型里写 morphTo()，不是 belongsTo()
被关联方（即评论）要用 morphTo()，这是最容易写反的地方。很多人照着一对多习惯写 belongsTo()，结果关系永远为空：
// ✅ 正确：Comment.php
public function commentable()
{
return $this->morphTo();
}
// ❌ 错误：不能用 belongsTo，它不读 commentable_type 字段
return $this->belongsTo(???, 'commentable_id');
注意：morphTo() 默认推导字段前缀为 commentable，对应数据库里的 commentable_id 和 commentable_type。如果字段叫 attachable_id，就得写成：$this->morphTo('attachable', 'attachable_id', 'attachable_type')。
关联方模型用 morphMany()，且建议配 morphMap
文章或视频这类“被评论对象”，要用 morphMany() 声明反向关系：
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
// Post.php
public function comments()
{
return $this->morphMany(Comment::class, 'commentable');
}
关键点：
-
morphMany第二个参数必须和Comment中morphTo()的方法名一致（这里是commentable） - 如果不希望数据库存完整类名（如
App\Models\Post），应在AppServiceProvider::boot()里注册映射：MorphMap::set(['post' => Post::class, 'video' => Video::class]) - 配了
morphMap后，数据库commentable_type字段就只存post或video，更短、更安全、迁移友好
查询时别漏掉 with() 的多态预加载语法
查文章并带出评论，再带出每个评论的作者（假设 Comment 有 user() 关联），容易写成两层嵌套 with 而失败：
// ❌ 不行：Laravel 不知道 commentable 是多态的，无法自动加载
->with('comments.user')
// ✅ 正确：用点号链式写法，Laravel 识别 morphTo 后自动处理
->with('comments.commentable')
如果想预加载 commentable 的某个特定关系（比如所有评论都带出文章的作者），得用闭包 + 条件判断，因为 commentable 可能是多个模型类型 —— 这块没有银弹，必须手动分情况处理。
多态关系真正难的不是定义，而是后续的所有操作：搜索（whereMorphedTo）、统计（withCount）、软删除联动、队列序列化……全都要围绕 commentable_type 字段做适配。字段命名和 morphMap 一旦定下，改起来成本很高。
