Laravel分页URL美化需自定义UrlGenerator并配合路由绑定，用withPath()设干净路径，而非改模板；CursorPaginator不适用此场景，因其用游标且不支持页码跳转。
分页 URL 里怎么去掉
这种参数
默认 Laravel 分页生成的链接是
，但 SEO 或路由一致性要求它变成
或
。这不是改模板就能解决的，得从分页器构造环节干预。
核心思路是：不靠
默认的 URL 生成逻辑，而是用自定义
替换掉它的
行为，再配合路由绑定让分页器“以为”当前路径已含页码。
在路由中显式声明页码段，比如
控制器里手动构建分页器时，传入不含查询参数的干净路径：
关键点：
的值必须和实际访问路径一致（不含
参数），否则分页器会自己补上
Laravel 10+ 用
能绕开 URL 美化问题吗
不能。游标分页（
）根本不用页码，它用
做状态传递，URL 结构更不可读，且无法跳转任意页——它和「美化页码 URL」是两个方向的问题。
如果你要的是「可预测、可书签、支持 SEO 的页码导航」，就必须用
，并控制它的路径生成逻辑。
适合无限滚动或大数据集的性能敏感场景，不是 URL 美化的替代方案
它不接受
，也不响应
，因为它的 URL 构建逻辑硬编码在
方法里
强行给游标分页加
路由会导致分页器内部状态错乱，翻页失效
自定义分页器 URL 时最容易踩的三个坑
多数人卡在“看起来改了，但点击后还是跳回
”，问题往往不在代码，而在路径匹配和上下文不一致。
Laravel 13.2.0
PHP中文网提供Laravel 13.2.0版本下载，Laravel框架 是基于 PHP 8.3+ 的高性能框架，官方推荐通过 Composer 安装。它内置 AI SDK、JSON:API Resources 及原生向量搜索，支持属性驱动开发与队列路由，大幅提升开发效率。相比旧版，13.2.0 优化了缓存 TTL 管理与实时通信，无需 Redis 即可横向扩展。作为现代 Web 开发首选，它兼顾安全与极速体验，助您快速构建企业级应用。
下载
路由命名没对齐：
里写的 URL 必须和当前请求的
解析出的 base path 完全一致，大小写、末尾斜杠都不能差
中间件干扰：某些权限中间件或语言切换中间件会重定向并丢掉原始 URL 上下文，导致分页器 fallback 到默认逻辑
视图里用了
却没传自定义渲染器：Laravel 默认分页视图仍会调用
，而这个方法依赖你之前设好的
；如果漏设，它就退回到 query string 模式
怎么让分页链接生成
而不是
可以，但得接受一个限制：这种扁平路径会让路由定义变得脆弱，尤其是当资源 ID 也是数字时（比如
可能被误认为是用户详情页）。
实现上只需两步：路由定义用可选参数 + 控制器内动态判断；分页器路径设为根级。
路由写成
控制器里区分请求类型：
注意：首页不能带
，否则 SEO 重复内容；
的
值会让第一页链接变成
，其余页才是
、
复杂点在于，所有分页链接必须严格遵循这个路径结构，稍有偏差（比如某处漏传
），整个链路就退回 query string。它不是配置开关，而是每个分页实例都要手动对齐的契约。
?page=2/users?page=2/users/page/2/users/2LengthAwarePaginatorUrlGeneratorsetPath()Route::get('/users/page/{page?}', [UserController::class, 'index'])->name('users.index');$users->withPath(url('users.page', ['page' => null]));withPath()page?page=CursorPaginatorCursorPaginator?cursor=xxxLengthAwarePaginatorCursorPaginatorwithPath()setPath()url()/page/2?page=withPath()request()->fullUrl()$users->links()$paginator->url($page)withPath()/users/2/users/page/2/users/2Route::get('/users/{page?}', [UserController::class, 'index'])->where('page', '[0-9]+')->name('users.index');if (is_numeric($page) && $page > 1) { $users = User::paginate(15)->withPath(url('users.index', ['page' => null])); }/1withPath()null/users/users/2/users/3['page' => null]