Laravel一对多关系需双向定义：Category模型用hasMany关联Post，Post模型用belongsTo关联Category；预加载用with('posts')避免N+1查询；whereHas用于关联条件筛选，非where。
一对多关系怎么写 belongsTo 和 hasMany
Laravel 里一对多（比如「文章 belongsTo 分类，分类 hasMany 文章」）不是靠手动写 SQL，而是靠模型里两个方向的关联方法互相指明。关键不是“定义关系”，而是“让两边都能正确反查”。
常见错误是只在一边写 hasMany，另一边漏掉 belongsTo，结果 $post->category 报错或返回 null。
-
hasMany写在“一”的模型里（如Category），返回集合，参数是关联模型类名，第二个参数是外键名，默认是category_id -
belongsTo写在“多”的模型里（如Post），返回单个模型，第一个参数是关联模型类名，第二个参数才是外键名（默认也是category_id），第三个参数才是主键名（默认id） - 如果数据库字段不是默认命名（比如用
cat_id），两边都得显式传参，否则查不到数据
Laravel 怎么预加载避免 N+1 查询
不加预加载时，$categories = Category::all(); foreach ($categories as $c) echo $c->posts->count(); 会触发 N 次查询——每个分类都单独查一次 posts，性能崩得很快。
用 with 预加载能合并成 2 次查询：一次查分类，一次查所有关联文章，并按外键自动分组。
- 写法是
Category::with('posts')->get()，其中'posts'必须和模型里定义的关联方法名完全一致（大小写敏感） - 如果只想要部分字段，用
with(['posts' => function ($q) { $q->select('id', 'title', 'category_id'); }])，但记得外键必须包含，否则关联失败 - 嵌套预加载如
with('posts.author')要确保Post模型里真有叫author的关联方法，拼错就静默失效
关联查询报错 Call to undefined relationship 怎么排查
这个错误说明你写的关联名在模型里根本没定义，或者方法名拼错了、没 public、或者用了驼峰但实际是下划线命名（比如写了 postComments 但方法叫 post_comments）。
- 检查模型中对应方法是否是 public，是否返回
HasMany或BelongsTo实例（不能 return null 或 echo） - 确认调用时用的字符串和方法名完全一致：
$user->posts对应public function posts()，不是post()或Posts() - 如果用了作用域或动态关联，别在
with()里传闭包以外的逻辑，with('posts.active')这种写法只有当active是真实定义的关联方法时才有效
什么时候该用 whereHas 而不是 where
where 只能查当前模型字段，比如 Post::where('status', 'published')；而 whereHas 是用来“筛选出那些有关联记录满足条件”的模型，比如「查至少有一篇已发布文章的分类」。
-
Category::whereHas('posts', function ($q) { $q->where('status', 'published'); })->get()才对 - 别写成
Category::where('posts.status', 'published')—— 这会报错，因为posts.status不是categories表的字段 -
whereHas默认是exists语义，如果要统计数量或加条件（比如「有至少 3 篇草稿」），得用withCount配合having
