Eloquent 关联写反会导致查错表且不报错：belongsTo 用于外键在当前模型表，hasMany 用于外键在关联表；belongsToMany 中间表字段顺序不可颠倒；whereHas 才能查关联字段；外键名不符约定需显式传参；外键须建索引且类型严格匹配主键。
belongsTo 和 hasMany 写反了就会查错表
Eloquent 不会校验你写的关联逻辑是否符合数据库事实，它只按你写的代码执行 SQL。最典型的问题是把“谁属于谁”搞反：
- 外键在当前模型对应的数据表里 → 用
belongsTo - 外键在对方表里 → 当前模型用
hasMany或hasOne
比如 Post 表里有 user_id 字段，那 Post::user() 必须是 belongsTo(User::class)；如果误写成 hasOne(User::class)，Eloquent 就会去查 posts.user_id = users.id 这种不存在的映射，结果永远是 null。
-
belongsTo默认查当前表字段匹配对方主键（如posts.user_id = users.id） -
hasMany默认查对方表字段匹配当前主键（如comments.post_id = posts.id） - 写反后生成的 SQL 条件方向错误，但不会报错，只会返回空
belongsToMany 中间表字段顺序不能颠倒
多对多不是“配对就行”，belongsToMany 的第四、第五个参数有严格语义：
- 第四个参数是「当前模型在中间表的外键名」
- 第五个参数是「关联模型在中间表的外键名」
例如在 User 模型里写：
return $this->belongsToMany(Role::class, 'user_role', 'user_id', 'role_id');意思是：从
user_role 表里，用 user_id 找当前用户，再用 role_id 去 roles 表查角色。
如果把后两个参数写成 'role_id', 'user_id'，Eloquent 就会拿 role_id 去匹配 users.id，数据全错绑。
whereHas 不能替代 where 直接查关联字段
想筛选“职业是 teacher 的用户”，不能写：
User::where('user_attr.job', 'teacher')->get();
这会报错或返回空——因为 user_attr 是关联，不是 users 表的字段。必须用：
User::whereHas('userAttr', function ($q) { $q->where('job', 'teacher'); })->get();
注意：
- 关系名 userAttr 必须和模型里定义的方法名完全一致（包括大小写）
- 闭包里的 $q 查询的是 user_attrs 表，所以直接写 'job'
- 如果还要取回关联数据，得额外加 with('userAttr')，否则查出来的 User 实例里 userAttr 是 null外键字段名不按约定就必须显式传参
Eloquent 默认按命名约定找外键：hasMany(Post::class) 会自动找 posts.user_id；如果实际字段叫 author_id，不传参就失效。
- 在
User::posts()里要写：return $this->hasMany(Post::class, 'author_id'); - 对应地，
Post::user()也得同步写：return $this->belongsTo(User::class, 'author_id');
漏掉任意一端，关联就断在某一边。更隐蔽的是改完没清缓存，php artisan config:clear和php artisan view:clear都不解决，得跑php artisan optimize:clear或重启队列/长连接进程。
真正容易被忽略的不是语法，而是外键字段有没有索引、类型是否和主键完全一致、迁移里有没有真正执行 foreignId()->constrained()。没索引的外键会让 whereHas 查询慢几倍，类型不一致（比如 BIGINT 主键配 INT 外键）会导致关联查不到数据且无提示。
