多态类型字段（commentable_type）存morphMap定义的键名如'post'，非全类名；未配morphMap时存全路径，易因命名空间变动报错；需在模型启动时注册映射且键名严格区分大小写。
多态类型字段（commentable_type）到底存什么？
存的是 morphMap 里定义的键名，比如 'post' 或 'video'，不是完整类名，也不是首字母大写的 'Post'。没配 morphMap 时，框架才退化为存 app\model\Post 这种全路径——但一遇到命名空间变动或自动加载失败，立刻报 Class not found。
常见错误现象：dump($comment->commentable) 返回 null，或者抛出方法不存在异常，八成是这里不匹配。
- 必须在模型启动阶段注册映射，例如在
app\common.php里调用think\Model::setMorphMap(['post' => app\model\Post::class]) -
morphMap键名严格区分大小写，'Post'和'post'是两个不同 key - 已有数据迁移时，不能只改配置，还得批量更新数据库里的
commentable_type字段值
morphTo 关联为什么总返回 null？
因为 morphTo 不会自动猜目标模型，它只认字段值 + 映射表。如果数据库里存的是 'Article'，而 morphMap 里只有 'article' => Article::class，那就对不上。
调试建议：直接查原始字段值，别依赖关联结果。
立即学习“PHP免费学习笔记（深入）”；
- 执行
Comment::where('id', 1)->value('commentable_type')和Comment::where('id', 1)->value('commentable_id')，确认值是否合理 - 检查
Comment模型里是否显式写了->morphTo('commentable', ['post' => Post::class, 'video' => Video::class])，而不是只靠默认行为 - 字段名不叫
commentable_type？那就必须传数组参数：$this->morphTo(['subject_type', 'subject_id'])
morphMany 的参数顺序和字段名必须严丝合缝
morphMany 看似简单，但第二个参数（多态字段前缀）和数据库字段名必须一致，否则查不到任何数据。它不会尝试推导，也不会报错，只是静默返回空集合。
典型场景：你建了 comments 表，字段是 owner_id 和 owner_type，但 Post 模型里写了 $this->morphMany(Comment::class, 'commentable') ——这就断开了。
- 正确写法是：
$this->morphMany(Comment::class, 'owner', 'owner_id', 'id')，其中'owner'会触发查找owner_type和owner_id - 如果主键不是
id（比如用 UUID），第四个参数必须显式传，如'uuid' - 字段类型要兼容：若
owner_id是VARCHAR(36)，那Post和Video的主键也得是字符串型，否则 SQL JOIN 时隐式转换失效
软删除下多态关联不自动过滤，得手动加条件
哪怕你在 Post 模型启用了软删除，$post->comments 拉出来的 Comment 记录仍可能包含已软删的；反过来，$comment->commentable 查到的 Post 也可能已被软删——框架默认不感知。
这不是 bug，是设计选择：多态关联本身不绑定生命周期策略。
- 在
morphMany定义里加作用域：->withTrashed(false)（TP6.1+） - 更可控的方式是在关联闭包里手动加：
->whereNull('posts.deleted_at') - 如果多个宿主模型都启用软删除，建议统一在基类里定义全局作用域，避免每个
morphMany都重复写
最常被忽略的一点：多态类型字段值和 morphMap 键名的大小写、拼写、前后空格，三者必须完全一致；差一个字符，关联就失效，而且没有任何提示。
