belongsTo必须定义在含外键的模型中，如订单表有user_id，则belongsTouser必须写在Order模型里；hasOne需显式指定外键字段名，否则默认按关联名小写加_id查找。
关联定义写反了，90% 的 case 不报错，只返回 null 或空对象——这不是 bug，是方向没对准。
belongsTo 必须写在含外键的模型里
外键在哪张表，belongsTo 就得定义在哪张表的模型中。比如订单表 order 有 user_id 字段，那 belongsTo(User::class) 就必须放在 Order 模型里，而不是 User 模型里。
常见错误现象：User::with('orders')->find(1) 返回 $user->orders 是空集合，但数据库里明明有对应订单。
- 检查
Order模型里有没有写public function user()—— 这是对的；但如果你在User模型里写了public function order()并用belongsTo，那就反了 -
hasOne和belongsTo不是“互为反向”，而是“各司其职”：谁存外键，谁写belongsTo - 如果硬要在
User模型里查订单，该用hasMany(Order::class, 'user_id')，不是belongsTo
hasOne 的第二个参数不填就是猜，一猜就错
hasOne 默认按「关联模型名小写 + _id」找外键，比如 Profile::class → 自动找 profile_id。但现实中，资料表字段几乎总是 user_id，不是 profile_id。
立即学习“PHP免费学习笔记（深入）”；
错误信息示例：SQLSTATE[42S22]: Column not found: 1054 Unknown column 'profile.user_id' in 'on clause'（注意：它在 profile 表里找 user_id，说明外键位置错了）
- 正确写法：
return $this->hasOne(Profile::class, 'user_id'); - 如果
users表主键不是id（比如叫uid），还得补第三个参数：->hasOne(Profile::class, 'user_id', 'uid') - 漏掉第二个参数，框架会生成错误的 ON 条件，SQL 执行可能成功但结果为空，排查时容易误判为数据缺失
with 预加载失效的三个隐藏原因
User::with('profile')->select() 看似写了预加载，结果还是 N+1 查询——问题往往不在 with 调用本身。
- 模型里的
profile()方法没加return，或者返回的是null/void，ThinkPHP 反射时直接跳过，当成没定义关联 - 方法名和
with()传的字符串不一致，比如方法叫userProfile()却写with('profile') -
profile()方法里用了new Profile()或静态调用，没返回Relation实例（如$this->hasOne(...)）
关联字段名和模型方法名撞车会静默覆盖
如果用户表有个字段叫 category_id，又在 User 模型里定义了 public function category()，访问 $user->category 时，ThinkPHP 会优先返回数据库字段值（category_id 的整数），而不是触发关联查询。
更隐蔽的情况：字段叫 order_count，方法也叫 orderCount()，调用 $user->orderCount 得到的是字段值，不是关联对象。
- 检查
Model::$schema或打印$user->toArray()，看同名字段是否已存在 - 关联方法命名尽量避开所有字段名，推荐用语义化动词或名词组合，比如
primaryCategory()、managedBy() - 实在无法规避，可在模型中设置
protected $hidden = ['category_id']，但需同步确认业务逻辑是否依赖该字段直取
最麻烦的不是报错，而是“看起来正常却查不到数据”——外键字段名、主键字段名、方法名、调用字符串，四个地方只要一个没对齐，关联就断在 SQL 生成前，连日志都难抓。动手改之前，先用 Db::getLastSql() 看一眼实际执行的语句，比翻文档快得多。
