morphmap必须在appserviceprovider::boot()中通过relation::morphmap()配置，不可写在模型boot()或config/app.php里；键为数据库commentable_type存储值（如post、content.post），值为完整类名字符串（如'app\models\post'）。
必须配 morphMap，否则换命名空间或重命名模型时，老数据直接查不到。
morphMap 配在哪？只能在 AppServiceProvider::boot() 里
不能写在模型的 boot()、不能放 config/app.php 的数组里，Laravel 只认 Relation::morphMap() 在服务提供者启动阶段的调用。漏掉这一步，commentable_type 字段哪怕存的是 post，也会报 Class post does not exist。
常见错误现象：
- 本地开发配了，线上环境没生效 → 检查是否只在本地
AppServiceProvider里写了，线上部署没同步 - 配了但不起作用 → 确认没写成
MorphMap::set()（这是旧版 API），新版统一用Relation::morphMap() - 配了多个地方（比如又在
Model::boot()里重复调）→ 后调用的会覆盖前一个，映射丢失
映射键名不能带命名空间，值必须是完整类名
键是数据库里 commentable_type 字段实际存储的字符串，比如 post、shop.product；值必须是带命名空间的完整类名，如 App\Models\Post 或 App\Models\Shop\Product。写成 'Post' => Post::class 是错的，因为 Post::class 在非命名空间上下文里解析为当前命名空间下的 Post，大概率不是你想要的。
实操建议：
- 一律用字符串字面量写完整类名：
'post' => 'App\Models\Post' - 如果要用常量，确保它本身已定义为完整类名字符串：
Post::class在模型文件里是安全的，但别在配置文件中直接引用未导入的类 - 模块化前缀（如
content.post）必须整个作为键，不能指望 Laravel 自动拆解：'content.post' => 'App\Models\Post'是合法的，但'content' => 'App\Models'这种“命名空间映射”无效
数据库字段值必须和 morphMap 键完全一致
配了 ['post' => 'App\Models\Post']，那数据库里 commentable_type 就只能存 post，存 App\Models\Post 或 Post 都会静默失败——查不到关联模型，$comment->commentable 返回 null，且无任何报错提示。
迁移历史数据时注意：
- 新项目：建表后立刻配好
morphMap，所有插入都走 Eloquent，自动写入短名 - 已有项目升级：必须批量更新旧数据，例如：
DB::table('comments')->where('commentable_type', 'App\Models\Post')->update(['commentable_type' => 'post']) - 兼容过渡期：可在
Comment模型里重写getMorphClass()，根据旧值返回新键，但仅限临时方案，不可长期依赖
whereMorphedTo() 必须传 morphMap 的键，不能传类名
这个方法不解析类，只做字符串等值匹配。写 Comment::whereMorphedTo('commentable', Post::class)，Laravel 会把 Post::class 当作字符串塞进 SQL 的 WHERE commentable_type = ?，结果查 App\Models\Post，而你数据库里存的是 post，必然查不到。
正确写法只有两种：
- 传映射键：
Comment::whereMorphedTo('commentable', 'post') - 传类实例（Eloquent 自动转键）：
Comment::whereMorphedTo('commentable', Post::first())
模块化场景下，whereMorphedTo('commentable', 'content.post') 是合法的，前提是 morphMap 里真有这一项。
最易被忽略的一点：morphMap 是全局生效的，一旦配错一个键，所有用到该类型的地方都会失效，而且问题往往延迟暴露——比如某次数据导出脚本突然返回空，才意识到 video 映射写成了 vedio。
