关联分页需避免with()或withCount()直接paginate()，因总数不准、SQL报错、翻页错乱；必须用whereHas()显式过滤主模型，paginate()置于链末，大表分页优先simplePaginate()或cursorPaginate()，自定义数据用LengthAwarePaginator手动构造。
关联查询分页不能只靠 with() 或 withCount() 加 paginate() 一塞了事——总数不准、SQL 报错、翻页错乱，基本是默认写法的常态。
with + whereHas 分页时主模型不被筛选？
这是最常踩的坑：写了 with(['posts' => fn ($q) => $q->where('status', 1)])，但用户列表里还是包含“没发过已发布文章”的人。原因很直接：with 只管预加载什么，不管主表要不要留。
- 必须显式加上
whereHas('posts', fn ($q) => $q->where('status', 1))，它才是真正过滤 User 的条件 - 两个闭包内容看起来重复，但语义完全分离：一个控制 JOIN 后取哪些 Post，一个控制 User 是否进结果集
- 分页方法（如
paginate(15)）一定要放在最后，中间不能插其他查询方法打断链式逻辑 - 如果关联表要排序或限数量（比如“每个用户只加载最新 2 篇”），
with()不支持limit，得用子查询或withCount配合后续处理
withCount 分页总数膨胀甚至为 0？
Post::withCount('comments')->paginate(10) 显示 total=47，实际只返回 8 条数据？这是因为 withCount 触发了 LEFT JOIN 子查询，而 paginate() 默认对整个 JOIN 结果 COUNT(*)，一条 Post 对应 5 条评论，就 counted 5 次。
- 正确做法：先用干净查询算总数，再传给
paginate()的第五个参数['total' => $total] - 示例：
$total = Post::where('status', 'published')->toBase()->count(); $posts = Post::where('status', 'published')->withCount('comments')->paginate(10, ['*'], 'page', 1, ['total' => $total]); - 如果同时用了
whereHas('comments', ...)，注意它走 INNER JOIN，和withCount的 LEFT JOIN 子查询语义冲突，可能导致comments_count === 0；统一改用 JOIN 写法或手动addSelect()替代
大表联查 + 分页卡顿？别硬扛 count
查 200 万订单并关联用户信息，paginate(20) 执行两秒以上，多半卡在 COUNT(*) 上——尤其带 JOIN 或 GROUP BY 时，MySQL 很可能全表扫描。
- 确认是否真需要总页数：前端只要「上一页/下一页」按钮，就换
simplePaginate(20)，它只执行带 LIMIT 的单条查询，跳过 COUNT - 如果必须显示「共 N 条」，但 count 太慢，可缓存总数（如每小时更新一次）、用估算值（
EXPLAIN的rows）、或改用游标分页cursorPaginate(20)（要求排序字段有唯一索引，如id或created_at） -
cursorPaginate()不依赖 offset，天然规避数据插入导致的翻页偏移问题，但不支持跳转任意页码
自定义 SQL 或第三方数据怎么分页？
当数据来自原生 SQL、视图、ES、API 或内存数组，paginate() 就不适用了——它只认 Eloquent 和 Query Builder。
- 用
LengthAwarePaginator手动构造：先查出完整 ID 列表（或全部数据），再切片 + 注入总数、当前页、每页数等元信息 - 关键点：
new LengthAwarePaginator($items, $total, $perPage, $currentPage, [...])中的$total必须是你自己算准的，不能依赖 Laravel 自动 COUNT - 路径和查询参数要手动传入：
['path' => request()->url(), 'query' => request()->query()]，否则生成的链接会丢参
关联分页真正的复杂点不在语法，而在 SQL 语义的隐式耦合：with、whereHas、withCount 各自触发不同 JOIN 类型，而 paginate() 的 COUNT 默认不感知这些变化。不拆开看执行计划，很容易以为“写对了”，其实数据库早就在默默膨胀或丢行。
