morphOne关系需严格对齐字段与声明：avatars表必须含avatarable_id、avatarable_type、created_at三字段，其中avatarable_type须为完整类名且大小写敏感；关系仅在拥有方（如User）定义，Avatar模型不写反向方法；操作时由Eloquent自动填充多态字段，禁止手动赋值。
morphOne 关系必须手动对齐数据库字段名和模型声明，否则查不到数据是常态，不是异常。
数据库表结构必须含三个固定字段
avatars 表不能只写 avatarable_id 和 image_path，缺一不可：avatarable_id（BIGINT 或 UUID，类型需与目标主键一致）、avatarable_type（VARCHAR，存完整类名如 App\Models\User）、created_at（Eloquent 默认需要）。常见错误是把 avatarable_type 写成 user 或 users，结果查询时类加载失败或匹配为空。
- 字段前缀
avatarable必须和模型中morphOne()的第二个参数完全一致 - 若实际字段是
attach_id+attach_type，则必须显式传参：->morphOne(Avatar::class, 'attach', 'attach_id', 'attach_type') -
avatarable_type值一旦写死进数据库，类名重构（如从App\User升级为App\Models\User）就会导致历史记录无法关联
User 模型里写 morphOne，Avatar 模型里不写反向关系
morphOne 是单向声明，只在“拥有方”模型中定义。User 有头像，就在 User 模型里加方法；Avatar 模型里不需要、也不应该写任何反向方法——它不知道自己属于谁，靠的是那两个字段动态解析。
- 正确写法：
public function avatar() { return $this->morphOne(Avatar::class, 'avatarable'); } - 错误写法：在
Avatar模型里写belongsToMorph()或belongsTo()—— 这是morphTo的用法，混用会导致关系错乱 - 调用时用
$user->avatar可取实例，$user->avatar()->create([...])可新建，但注意它会自动填入avatarable_id和avatarable_type
查询多态数据时，whereMorphedTo 不等于 where
whereMorphedTo() 是 Eloquent 提供的专用作用域，用于高效筛选某类来源的数据。直接 where('avatarable_type', 'App\Models\Post') 虽然能查到，但绕过了类型校验，且无法复用预加载逻辑。
- 查所有用户头像：
Avatar::whereMorphedTo('avatarable', User::class)->get() - 查某用户头像：
$user->avatar就够了，不用额外where - 如果用
with('avatarable')预加载，必须确保Avatar模型里定义了avatarable()方法并返回morphTo()，否则报错 Class not found
更新或创建时，不要手动赋值 avatarable_id / avatarable_type
Eloquent 在调用 $user->avatar()->create() 或 $user->avatar()->updateOrCreate() 时，会自动注入正确的 ID 和类名。手动塞值不仅多余，还可能因类名拼写错误或 ID 类型不匹配导致静默失败。
- 正确：
$user->avatar()->create(['image_path' => '/a.png']) - 危险：
Avatar::create(['avatarable_id' => $user->id, 'avatarable_type' => 'App\User', ...])—— 类名过期、ID 类型错、没走模型事件 - 事务中更新
morphOne记录，无需 detach/attach（那是morphToMany才用的），直接save()或update()即可
最容易被忽略的是 avatarable_type 字段内容必须和 get_class($model) 完全一致，包括命名空间大小写、末尾是否带 Model 后缀——哪怕只差一个反斜杠，关联就断了。
