laravel模型关联需同时满足foreign_key命名正确、local_key指向明确、关系方法返回的构造器类型与外键逻辑一致；任一缺失将导致relation not loaded或空数组。
直接说结论：Laravel 模型关联不是“配对成功就行”，而是必须同时满足三件事——foreign_key 命名正确、local_key 指向明确、关系方法返回的 belongsTo/hasMany 等构造器类型与数据库外键逻辑一致；漏掉任一，relation not loaded 或空数组就是常态。
foreign_key 字段名不按约定就失效
Eloquent 默认依赖命名约定，比如 User 有 posts() 方法（hasMany），它会自动查找 posts.user_id 字段；如果实际字段叫 author_id，不显式声明就会查错列，返回空集合。
- 解决方式：在关系方法里传入第二个参数（
foreignKey）public function posts() { return $this->hasMany(Post::class, 'author_id'); } - 注意：这个
author_id是posts表里的字段名，不是模型属性名 - 反向关系（
Post找User）若用belongsTo，也要同步指定：public function user() { return $this->belongsTo(User::class, 'author_id'); }
belongsTo 和 hasMany 容易写反方向
新手最常把“谁属于谁”搞混。记住一个判断口诀：看外键在哪张表——外键在当前模型对应的数据表里，就用 belongsTo；外键在对方表里，当前模型用 hasMany 或 hasOne。
-
Post表含user_id→Post属于User→Post::user()必须是belongsTo -
User表不含post_id→User不属于Post，而是拥有多个Post→User::posts()是hasMany - 如果强行把
User::posts()写成belongsTo(Post::class)，Eloquent 会去查users.post_id，字段不存在，结果为 null
多对多中间表字段名和模型名必须严格匹配
belongsToMany 关系默认要求中间表名为两个模型单数名按字母序拼接（如 role_user），且字段为 role_id 和 user_id；任意一项不符，就必须全量指定。
- 中间表不是
role_user？传第三个参数：return $this->belongsToMany(Role::class, 'user_roles');
- 中间表字段不是
user_id/role_id？补第四、第五个参数：return $this->belongsToMany(Role::class, 'user_roles', 'user_id', 'role_id');
- 注意顺序：第四个是“当前模型在中间表的外键”，第五个是“关联模型在中间表的外键”——写反会导致数据错绑
真正麻烦的从来不是写关系方法，而是改完之后忘记清缓存或没跑 php artisan config:clear；更隐蔽的是，有些关联在 tinker 里能查出来，但加了 with() 预加载后报错——那八成是 localKey 或 ownerKey 没对齐，得翻 Eloquent 源码里 HasRelationships.php 看构造器参数顺序。
