查不到关联数据但没报错，大概率是 belongsTo 和 hasOne 方向写反：User 表含 category_id 则 User belongsTo Category；Category 表含 admin_id 才用 hasOne。
belongsTo 和 hasOne 写反了查不到数据，怎么快速定位
查不到关联数据但没报错，大概率是 belongsTo 和 hasOne 方向写反。关键不是记方法名，而是想清楚「谁属于谁」：如果 User 表里有 category_id 字段，那 User 就 belongsTo Category；反过来，Category 表本身不存用户 ID，它只「拥有一个」管理员（比如 admin_id），才用 hasOne。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
-
belongsTo必须显式传foreignKey（本模型的外键字段），ThinkPHP 不会自动猜你把cat_id当成外键 -
hasOne的第二个参数是「关联表里的外键字段名」，常见误区是填成profile_id（错），实际应为user_id（对） - 两个模型都定义关联方法时，
belongsTo侧的第三个参数要对齐对方主键名，比如对方主键是uid，就得写->belongsTo(User::class, 'user_id', 'uid')
with 预加载没生效，SQL 还是 N+1
with 没减少查询次数，通常不是语法问题，而是模型方法没真正“被识别”：ThinkPHP 是靠反射调用关联方法，方法体里没 return，就等于没定义。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 检查关联方法是否以
public function xxx()声明，且末尾有return $this->belongsTo(...)—— 少一个return，with就静默失效 - 嵌套预加载如
with(['category', 'profile.address'])，要求Profile模型也正确定义了address()方法，缺一个就断在第二层 - 只查部分字段时，用闭包约束：
with(['category' => function ($q) { $q->field('id,name'); }])，避免拖回整张表
belongsToMany 多对多查不出数据，中间表配置错在哪
调用 $user->roles 返回空集合，90% 是中间表字段或命名没对齐。ThinkPHP 默认按字母顺序拼中间表名（role_user），并找 user_id 和 role_id 字段——现实项目几乎都不按这个来。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 不要依赖约定，全量写死参数：
belongsToMany(Role::class, 'sys_user_role', 'uid', 'rid', 'id', 'id')，其中第 2–6 个参数分别对应：中间表名、当前模型外键、关联模型外键、当前模型主键、关联模型主键 - 中间表有额外字段（如
created_at、status）必须建中间模型，并用->through(UserRole::class)显式指定，否则pivot属性为空 - 确认中间表数据里，
uid和rid值确实存在且类型匹配（比如不能一边是字符串一边是整型）
join 和 with 返回的数据结构差异影响后续操作
join 出来是一维数组，字段平铺（如 user.name, category.name）；with 返回的是嵌套对象（$user->category->name）。选哪个不是看“哪个高级”，而取决于你要怎么用数据。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 需要对关联字段做
where或order，只能用join，with的闭包只能约束关联模型自身的条件 - 要做分页且关联数据量大，
with更稳：先查主表再批量查关联，避免join笛卡尔积导致重复行和性能抖动 -
join结果不是完整模型实例，无法触发afterFind等模型事件，也不能直接调用save()
最常被忽略的一点：用 with 查出来的关联对象（比如 $user->category）默认是只读快照，改了 $user->category->name 再调 save()，数据库不会变——得重新实例化或用 load() 刷新。
