多态字段名必须为“关系名_id/type”，如commentable_id/commentable_type，不可自定义；morphto()参数顺序为(关系名, id字段, type字段)；未配morphmap时type存完整类名，需手动映射并迁移旧数据；预加载只能用关系名commentable而非模型名。
多态字段名必须是 xxx_id + xxx_type 组合
不能自定义成 target_id/resource_type 这类名字，除非你显式传参覆盖默认行为。Laravel 的 morphTo() 和 morphMany() 默认只认 {name}_id 和 {name}_type 这对字段，其中 {name} 是你在关系方法里声明的关联名（比如 commentable），不是模型名也不是表名。
常见错误现象：Comment::with('commentable')->get() 返回 commentable 为 null，但数据库里字段明明有值——大概率是字段叫成了 post_id / video_type，或者用了 comment_id / comment_type 这种和关系名不匹配的组合。
- 迁移中必须用
$table->morphs('commentable')，它会自动建出commentable_id（类型为unsignedBigInteger）和commentable_type（类型为string） - 如果手动写字段，
commentable_type字段长度至少要 191（MySQL utf8mb4 下索引限制），否则whereHas类查询可能报错 - 字段名大小写敏感：MySQL 默认小写，
Commentable_id和commentable_id是两个字段
morphTo() 的参数顺序容易写反
morphTo() 默认推导字段前缀，但一旦你改了字段名，就必须显式传参，且顺序固定：第一个是关系名（可选），第二个是 ID 字段名，第三个是 type 字段名。漏掉或颠倒就会查不到数据。
比如字段实际是 attachable_id 和 attachable_type，但你在 Comment 模型里写了：
return $this->morphTo('attachable', 'attachable_type', 'attachable_id'); // ❌ type 和 id 位置反了
结果 commentable_type 被当成了 ID 去查，直接报错或返回空。
- 正确写法：
return $this->morphTo('attachable', 'attachable_id', 'attachable_type'); - 如果只是想改关系名（比如叫
owner），但字段还是commentable_id/type，那就只能写：return $this->morphTo('owner', 'commentable_id', 'commentable_type'); - 不传参时，
return $this->morphTo();等价于return $this->morphTo('commentable', 'commentable_id', 'commentable_type');
没配 morphMap 时 commentable_type 存的是完整类名
不配 morphMap，Laravel 会把 App\Models\Post 这种完整命名存进 commentable_type 字段。这本身没问题，但一旦你改了命名空间、模型路径，或者部署时 autoloader 出问题，就立刻报 Class not found。
更隐蔽的问题是：开发环境类名短（比如只写 Post），但生产环境没配 morphMap，数据库里存的却是 Post，而 Laravel 实际加载的是 App\Models\Post，导致查出来 commentable 是 null。
- 必须在
AppServiceProvider::boot()里注册：Relation::morphMap(['post' => 'App\Models\Post', 'video' => 'App\Models\Video']); - 配完之后，数据库里
commentable_type存的就是post或video，而不是长字符串 - 已有数据需手动迁移：用
DB::table('comments')->where('commentable_type', 'App\Models\Post')->update(['commentable_type' => 'post']);
预加载 with('commentable') 时别漏掉 commentable 关系名
很多人写 Comment::with('post') 或 Comment::with('video')，这是无效的——commentable 是你在 Comment 模型里定义的关系方法名，不是模型名。Eloquent 不会根据 commentable_type 自动猜你要预加载哪个模型。
错误示例：Comment::with('post')->get() → 返回所有评论，但 commentable 仍是 null，因为没声明叫 post 的关系。
- 正确写法只有：
Comment::with('commentable')->get() - 如果还想进一步预加载
commentable下的子关系（比如文章作者），得写：Comment::with('commentable.author')->get() - 注意：这种嵌套预加载要求
commentable方法返回的每个模型都定义了author关系，否则运行时报错
最常被忽略的一点：多态关联不是“设个配置就通了”，它极度依赖字段名、类名、映射三者严格对齐。哪怕 commentable_type 字段里多了一个空格，或者 morphMap 里键值写反了，都会静默失败——查不到数据，也不报错。
