直接用paginate()能运行但存在参数透传缺失、COUNT失败和UNION/GROUP BY报错等问题：需用appends()传递筛选参数，simplePaginate()规避COUNT瓶颈，UNION需子查询包装，DISTINCT需手动构造LengthAwarePaginator。
直接用 paginate() 就能跑起来，但不处理参数透传、COUNT 失败或 UNION 场景，点两下就 500 或漏数据。
paginate() 调用后没报错但分页链接点不开
默认只保留 page 参数，顶部搜索条件（比如 status=active&keyword=test）不会自动带过去，点第二页就回到无筛选状态。
- 控制器里传参：在返回视图前对分页器调用
appends($request->query())，例如$users->appends($request->query()) - 视图里渲染：必须用
{{ $users->links() }}，不能手写<a href="?page=2">，否则链接里没条件参数 - 注意
appends()会覆盖同名键，如果前端传了page=1再appends(['page' => 2])，结果还是 page=2 —— 这是预期行为，不是 bug
GROUP BY / DISTINCT / UNION 后调用 paginate() 报错
Laravel 的 paginate() 底层会额外执行一条 COUNT(*) 查询，而含 GROUP BY 或 UNION 的语句无法直接套 COUNT，抛出 SQLSTATE[42000]: Syntax error 类错误。
- 简单 GROUP BY 场景：改用
simplePaginate()，它不查总数，只判断“是否有下一页”，SQL 变成LIMIT 16（取 n+1 条），性能更好但少个总页数显示 - UNION 场景：得把整个 UNION 查询包装成子查询，再对子查询分页，例如
DB::table(DB::raw("($unionSql) as a"))->mergeBindings($union)->paginate(10) - DISTINCT 场景：手动统计总数（
count()单独查）+LengthAwarePaginator手动构造分页器，避免 COUNT 失败
分页数据渲染时拿不到模型方法或关系
用 DB::table() 调用 paginate() 返回的是 stdClass 对象数组，不是 Eloquent 模型实例，所以 $post->author->name 会报错。
- 优先改用 Eloquent 模型：哪怕只是
Post::select(...)->where(...)->paginate()，也能保持模型行为 - 实在要用查询构造器：在控制器里用
with()预加载关联（不支持），或改用from()包装子查询，再通过模型newQuery()->from(...)->paginate() - 临时方案：遍历
$posts->items()后手动补关联数据，但 N+1 问题得自己控制
自定义分页样式但页面没变化
执行 php artisan vendor:publish --tag=laravel-pagination 后，模板文件生成在 resources/views/vendor/pagination/，但 Laravel 5.5 默认用的是 default.blade.php，不是 bootstrap-4.blade.php（那是 5.6+ 的默认名）。
- 确认发布成功：检查
resources/views/vendor/pagination/default.blade.php是否存在且被修改过 - 强制指定模板：视图中写
{{ $users->links('pagination.default') }}，避免框架找错文件 - API 响应不走这个逻辑：JSON 接口不要改这个模板，直接用
$users->toArray()或手动构造 meta 字段
真正卡住人的从来不是怎么分页，而是分页器背后那条隐式 COUNT 查询什么时候失效、参数怎么不丢、以及对象类型在哪儿悄悄变了。
