belongsTo 关联必须定义在被关联模型（如 Order）中，通过 user() 方法返回 belongsTo(User::class, 'uid', 'user_id') 实例，需显式指定外键和主键，避免依赖自动推断，并注意预加载、全局作用域及数据完整性。
belongsTo 关联定义写在哪
归属关联（belongsTo）必须写在「被关联的模型」里，不是主表模型。比如订单 order 属于用户 user，那就要在 Order 模型中定义 belongsTo，指向 User 模型。
常见错误是反着写：在 User 模型里写 belongsTo，结果查不到关联数据，或者报 Call to undefined method 错误。
- 正确位置：
app\model\Order.php中的user()方法 - 方法名通常用单数、小驼峰（如
user、category），和外键字段语义对应 - 返回值必须是
belongsTo()实例，不能只写return $this->belongsTo(User::class);就完事——要确保User类已正确引入
外键和主键参数怎么填才不翻车
belongsTo 默认按「模型名小写 + _id」找外键（如 user_id），主键默认是 id。但实际项目里外键名五花八门，不显式指定就容易查出 null 或报错 Unknown column 'user.id'。
必须核对三处：数据库字段名、关联方法参数、目标模型主键名。
立即学习“PHP免费学习笔记（深入）”；
- 如果订单表外键叫
uid，就得写：$this->belongsTo(User::class, 'uid') - 如果
User表主键不是id（比如是user_id），要补第三个参数：$this->belongsTo(User::class, 'uid', 'user_id') - 别依赖自动推断——尤其当模型命名不规范（如
Member模型对应表members但主键是member_id）时，三个参数全写清最稳
关联查询时数据为空？先看这三点
调用 $order->user 返回 null，不一定是代码写错了，更可能是数据或查询方式问题。
- 检查外键值是否为 null 或 0：
var_dump($order->uid)，空值或非法值不会触发关联查询 - 确认是否用了延迟加载（lazy load）：直接访问
$order->user是懒加载，但若$order是通过where查出来的集合，得用with('user')预加载，否则每循环一次都查一次库（N+1 问题） - 注意作用域影响：如果
User模型里写了全局作用域（basescope），而被关联的记录被 scope 过滤掉了（比如 status=0 被排除），也会返回 null —— 此时可在belongsTo后加->withoutGlobalScope()
关联字段需要别名或额外条件怎么办
原生 belongsTo 不支持直接加 where 条件，也不能改字段别名。想查「启用状态的用户」或把 user.name 变成 username，得靠闭包或模型事件。
- 加条件：用闭包传参，
$this->belongsTo(User::class, 'uid')->where('status', 1) - 字段别名：不能直接 alias，但可以在
User模型里定义获取器（getUsernameAttr），或在关联后用hidden/visible控制输出字段 - 注意性能：闭包里的
where会拼进 JOIN 的 ON 条件，不是 WHERE，所以status字段必须在users表里存在，且索引有效
真正麻烦的不是写法，而是外键值缺失、主键类型不一致（比如 user_id 是 bigint，但关联时当成 int 处理）、还有全局作用域静默过滤——这些地方一漏，查半天看不出哪错了。
