hasOne和belongsTo必须成对定义，单写一个查不到数据；前者写在无外键的主表模型中，参数为（关联类名、从表外键、主表主键），后者写在含外键的从表模型中，参数为（关联类名、本表外键、对方主键），外键与主键字段名须严格匹配。
hasOne 和 belongsTo 不是“选一个”，而是“必须配对写”
单写 hasOne 或单写 belongsTo 都会查不到数据，这不是配置遗漏，而是 ThinkPHP 的关联机制根本没被触发。框架不自动推断外键位置、不猜主键名、不反向补全关系——它只按你写的代码执行 SQL。
常见错误现象：User::with('profile')->find(1) 返回 profile 为 null，但数据库里明明有对应记录；或者 $user->profile 是空对象，dump($user->profile->toArray()) 报错说访问了 null 对象。
-
hasOne写在主表模型（如User）里，表示“我有一条从记录”，但它只负责生成 JOIN 条件或子查询，不自动加载 -
belongsTo写在从表模型（如Profile）里，表示“我属于某条主记录”，它定义了反向查找的依据，但不参与with()的主查询路径 - 两者必须同时存在，且外键/主键参数要严格对应，否则
with()找不到入口，load()也查不出结果
外键字段名不等于 “模型名_id”，这是最常漏掉的参数
hasOne 默认按关联模型名小写 + _id 猜外键（比如关联 Profile 就找 profile_id），但现实中从表外键几乎总是叫 user_id、order_id 这类“主表名_id”。一猜就错，还静默失败。
正确写法必须显式传第二个参数：
立即学习“PHP免费学习笔记（深入）”；
public function profile()
{
return $this->hasOne(Profile::class, 'user_id');
}
如果主表主键不是 id（比如是 uid），还得补第三个参数：
return $this->hasOne(Profile::class, 'user_id', 'uid');
- 不填
'user_id'→ 框架查profile_id字段 → 字段不存在 → 返回空对象 - 不填
'uid'→ 框架用id去匹配 →WHERE profile.user_id = user.id→ 查不到（因为 user 表主键是 uid） - 参数顺序不能错：
hasOne('关联类', '本模型外键', '对方主键')
belongsTo 的外键参数是“本模型字段”，不是“对方字段”
很多人把 belongsTo 的第二个参数当成“对方表的字段名”，结果写成 ->belongsTo(User::class, 'id')，SQL 直接报错：Unknown column 'profile.id' in 'where clause'。
实际含义是：“我在哪一列存了对方的主键？”——所以这个字段一定在当前模型对应的表里。
- Profile 表外键是
user_id→ 写->belongsTo(User::class, 'user_id') - Profile 表外键是
owner_id→ 写->belongsTo(User::class, 'owner_id') - User 表主键是
uid→ 第三个参数必须是'uid'，不是'id' - 错误示例：
->belongsTo(User::class, 'id', 'uid')—— 第二个参数'id'是 Profile 表里不存在的字段
关联方法名必须和 with() 参数一致，且不能有空格或下划线冲突
with('profile') 调用的是模型里名为 profile() 的方法。方法名不匹配，关联直接跳过，不报错也不查数据。
- 方法名写成
userProfile()，就必须用with('userProfile')，不能简写为with('profile') - 方法名含下划线（如
user_profile()），调用时得用驼峰转下划线规则：with('user_profile')→ 框架会自动转成userProfile方法？不，不会。它严格按字符串匹配 - 建议统一用小写字母+下划线命名方法，如
profile()、address()，避免大小写或命名风格引发的隐性失败 - 别名定义（第四个参数）极少用，除非多个关联指向同一模型，否则徒增复杂度
hasOne 的第二个参数是“从表外键”，belongsTo 的第二个参数也是“从表外键”，但新手常以为后者该填“主表字段”。方向感一错，整个关联链就断在第一步。 
