Laravel关联方法均支持自定义外键和主键，但参数顺序与含义各异：belongsTo第二参数是本表外键（如'owner_id'），hasOne/hasMany第二参数是关联表外键（如'user_id'），第三参数为本地主键（默认'id'）；belongsToMany需显式指定中间表名、本模型外键、关联模型外键；外键无索引会导致whereHas性能骤降。
直接说结论：Laravel 关联方法（belongsTo、hasOne、hasMany、belongsToMany）都支持显式传入自定义外键和主键，但参数顺序和含义完全不同，错一个就查不到数据或报错。
belongsTo 和 hasOne/hasMany 的外键参数位置相反
这是最容易踩坑的地方。两个方法都接受「外键名」，但它在参数列表里的位置不同：
-
belongsTo的第二个参数是外键名（即当前模型里存的“对方 ID”字段）：belongsTo(User::class, 'owner_id') -
hasOne/hasMany的第二个参数才是外键名（即关联表里存的“本模型 ID”字段）：hasOne(Profile::class, 'user_id') - 第三个参数才是本地主键名（默认是
id），只有当本模型主键不是id时才需要传，比如用uuid或nik：belongsTo(User::class, 'owner_id', 'uuid')
常见错误现象：Call to undefined relationship 或返回空集合，实际是外键字段名写错位置，Eloquent 去找默认的 user_id 却不存在。
belongsToMany 中间表外键必须全手动指定
多对多关系不走默认约定时，三个关键字段都要显式声明：
- 中间表名（第二个参数）：
'article_tag' - 本模型在外键表中的外键名（第三个参数）：
'article_id' - 关联模型在外键表中的外键名（第四个参数）：
'tag_id'
示例：belongsToMany(Tag::class, 'article_tag', 'article_id', 'tag_id')
注意：中间表命名默认按字母序（article_tag 而非 tag_article），如果迁移文件里建的是 tag_article，就必须显式传参，否则 Eloquent 会去查不存在的表。
whereHas 性能差？先确认外键有没有索引
whereHas 生成的是 EXISTS 子查询，如果中间表或关联表的外键字段没加索引，几万条数据时延迟秒级起步。
- 检查迁移中是否加了索引：
$table->index('article_id');和$table->index('tag_id'); - 避免在
whereHas闭包里写whereRaw或复杂条件，它无法有效利用索引 - 真要多条件筛选，优先用
withWhereHas（Laravel 10.42+）或先with再用集合过滤
典型错误：在 Article::whereHas('tags', fn ($q) => $q->where('name', 'php')) 里查不到结果，不是代码写错，而是 tags.name 没索引，查询被优化器放弃走索引。
with 预加载后访问属性报 “Undefined property”
with 不会改变模型属性是否存在，它只是把关联数据查出来并挂载到对象上；如果关联记录被删了或外键为空，$article->author 就是 null，不是空集合。
- 别直接写
$article->author->name，先判空：optional($article->author)->name或更稳妥的$article->author?->name - 如果业务上要求「必须有 author」，就在迁移里加外键约束，并在模型里用
belongsTo()->isRequired()（Laravel 11+）让查询失败得更早 - 别依赖
with来兜底数据完整性 —— 它解决的是 N+1，不是数据缺失
最常被忽略的一点：自定义外键后，with 依然按你传的参数去拼 SQL，如果中间表字段名写错，预加载会静默失败（查不到数据但不报错），只能靠日志或 DB 查询验证。
