Laravel分页默认只保留page参数，order等业务参数需用appends()手动追加，推荐appends(request()->only(['order', 'direction']))；自定义分页视图须确保使用request()->except('page')，避免硬编码覆盖；withQueryString()会携带所有查询参数，存在URL膨胀与安全风险，不建议在只需order/direction时使用。
分页链接里 order 参数丢失的直接原因
默认情况下，Laravel 的 paginate() 方法只保留当前 URL 的查询参数中与分页相关的内容（如 page），其他参数（比如 order、sort、search）会被自动过滤掉。这不是 bug，是设计如此——框架默认假设你只关心分页跳转，不主动继承业务参数。
用 appends() 手动追加排序参数
最常用也最可控的方式，是在调用 paginate() 后链式调用 appends()，把需要透传的参数塞回去。注意不是所有参数都得 append，只追加你实际用于控制查询逻辑的那些。
- 如果 URL 是
/users?order=name&direction=asc，且你在控制器里用request('order')和request('direction')构建查询，则必须同时 append 这两个键 -
appends()接收数组或键值对，推荐用appends(request()->only(['order', 'direction']))，避免手动判断空值 - 不要写成
appends(['order' => request('order')])—— 当order未传时会 appendorder=null，导致链接里出现?order=&page=2，难看且可能干扰前端判断
Users::query()
->when(request('search'), fn ($q) => $q->where('name', 'like', '%'.request('search').'%'))
->orderBy(request('order', 'id'), request('direction', 'desc'))
->paginate(15)
->appends(request()->only(['search', 'order', 'direction']));
前端渲染分页时 order 参数被覆盖的隐患
Laravel 默认的 resources/views/vendor/pagination 模板生成的链接，底层调用的是 $paginator->appends($params)->url($page)。如果你在控制器里没传参或传错，模板里就看不到 order；更隐蔽的问题是：某些自定义分页视图会硬编码 appends(['page' => $page])，直接把其他参数清空了。
Laravel Cloud
下载
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
- 检查你用的分页视图是否来自
vendor，如果是，运行php artisan vendor:publish --tag=laravel-pagination把它导出到resources/views/vendor/pagination再修改 - 确保模板里分页链接生成逻辑是
$paginator->appends(request()->except('page'))->url($page)或类似方式，而不是固定写死参数 - 如果用了第三方分页组件（比如 Alpine + Livewire），注意它内部是否重新构造 URL——这时要自己在 JS 里读取并拼接
order和direction
用 withQueryString() 替代手写 appends()？
Laravel 9+ 提供了 withQueryString()，看起来很省事，但它会把 *所有* 查询参数都带上，包括你根本不用的（比如调试用的 debug=1、埋点用的 utm_source），容易让 URL 膨胀甚至泄露敏感信息。
-
withQueryString()等价于appends(request()->all())，不加筛选 - 如果你明确只要
order和direction，就别用它——多 append 一个无关参数，就多一分被滥用的风险 - 某些部署环境（如 CDN 或 WAF）会对长 URL 截断或拒绝，
withQueryString()在复杂筛选页下很容易触发这类限制
真正麻烦的不是怎么加参数，而是哪些参数该加、加到哪一层：查询构建时用的参数，要进 appends()；前端 JS 触发分页时，也要同步读取当前 order 值并带过去。漏掉任意一环，用户点第二页就回到默认排序。
