whereMorphedTo仅支持精确匹配已知类型，生成WHERE type = ? AND id = ?语句，不支持模糊查询；需确保morph map配置与数据库存储值一致，否则静默失败。
whereMorphedTo 只能查「已知类型」，不能模糊匹配
这个方法本质是生成 WHERE type = ? AND id = ? 的 SQL，它不支持通配、正则或 like 查询。如果你传入 Post::class，Laravel 就会把 type 字段值硬编码为 "App\Models\Post"（或你配置的别名），然后查对应 id。它不是“找所有能关联到 Post 的记录”，而是“找明确标记为 Post 类型且 ID 匹配的记录”。
常见错误现象：
• 用 whereMorphedTo('commentable', 'App\Models\Article') 却查不到数据，实际数据库里 commentable_type 存的是 "Article"（短名）
• 想查“所有 commentable 是文章类的记录”，却误以为 whereMorphedTo 能做类型前缀匹配
- 确保模型的
$morphClass属性或Relation::morphMap()配置与数据库存储值完全一致 - 如果用了 morph map（比如
['article' => Article::class]），必须用 key（'article'）而非类名调用whereMorphedTo - 想实现模糊类型筛选？得手动写
whereRaw("commentable_type LIKE '%Article%'")，但注意这会绕过 Eloquent 类型安全和自动反序列化
多态关联查询时，whereMorphedTo 和 whereMorphedToIn 行为差异
whereMorphedTo 是单类型精确匹配；whereMorphedToIn 才是多类型等价于 IN 查询——但它仍然只比对 type 字段，不校验 id 是否真实存在或是否属于该类型。
使用场景：
• 你要查「被某篇文章或某个视频评论过的用户」→ 用 whereMorphedToIn('commentable', [Post::class, Video::class])
• 你要查「被 ID=5 的某篇 Post 评论过的用户」→ 必须用 whereMorphedTo('commentable', Post::class, 5)
-
whereMorphedToIn不接受 ID 参数，它只生成commentable_type IN (?, ?)，不会加commentable_id = ? - 如果同时要限定 type 和 id，又涉及多个 type，只能手写
whereIn(...)->where(...)或用子查询 - 注意：
whereMorphedToIn在 Laravel 9.23+ 才支持传入类名数组；旧版本需先用Relation::getMorphedModel()显式转成字符串
whereMorphedTo 在 withCount / exists / whereDoesntHave 中容易失效
这些方法底层依赖关系预加载或子查询，而 whereMorphedTo 是在主查询加条件。一旦混用，Eloquent 可能忽略多态类型约束，或生成错误的 JOIN 条件。
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
典型错误：
• Comment::withCount(['commentable' => fn ($q) => $q->whereMorphedTo('commentable', Post::class)])->get() → 实际没生效，count 还是全量
• Post::whereDoesntHave('comments', fn ($q) => $q->whereMorphedTo('commentable', Post::class)) → 逻辑错乱，因为 commentable 是 comments 表的字段，不是 posts 表的
- 在
withCount里限制多态目标类型，必须用闭包里的where直接操作外键字段：withCount(['comments' => fn ($q) => $q->where('commentable_type', Post::class)]) -
whereDoesntHave对多态关系慎用；更可靠的是用反向查询：Post::whereNotIn('id', Comment::where('commentable_type', Post::class)->pluck('commentable_id')) - 所有带子查询的多态操作，务必用
toSql()看生成的 SQL，确认commentable_type条件落在了正确的位置
自定义 morph map 后，whereMorphedTo 的参数必须同步更新
一旦你在 AppServiceProvider::boot() 里注册了 Relation::morphMap(['post' => Post::class])，数据库里存的就是 "post"，而不是完整类名。这时如果还传 Post::class 给 whereMorphedTo，就会查不到数据——因为 Laravel 会拿 Post::class 去算出 "App\Models\Post"，再跟数据库里的 "post" 对不上。
- 启用 morph map 后，
whereMorphedTo第二个参数必须是 map 的 key，例如whereMorphedTo('commentable', 'post') - 不确定当前用的是类名还是 key？可以临时打印：
Relation::getMorphedModel('post') // → App\Models\Post - 全局搜索项目中所有
whereMorphedTo调用点，检查是否遗漏了 map key 切换 —— 这是最常被忽略的兼容性断点
多态类型的字符串匹配看似简单，但 class name、morph key、数据库值三者只要有一处不一致，查询就静默失败。最稳妥的做法是：统一用 Relation::getMorphedModel() 反查，或者干脆在模型里封装一个 scopeWhereCommentableIs() 方法来收口逻辑。
