将分页参数名从page改为p，需在AppServiceProvider的boot()中调用Paginator::usePageName('p')；保留其他查询参数用appends(request()->except('page'))；子路径部署需配置URL::forceRootUrl()或APP_URL环境变量。
分页 URL 参数名怎么改（page 变成 p）
Laravel 默认所有分页链接都用 page 作为查询参数，比如 /posts?page=2。想改成 /posts?p=2，不能只改模板里的链接——那只是表面，真实分页逻辑仍认 page，改了反而 404 或始终显示第一页。
关键在 LengthAwarePaginator 和 SimplePaginator 的构造参数，以及全局配置入口。Laravel 9+ 后，app/Providers/AppServiceProvider.php 是最稳妥的修改点。
- 在
boot()方法里调用Paginator::usePageName('p') - 这会影响所有后续创建的分页器（包括
paginate()、simplePaginate()），但**不改变已存在的分页实例** - 如果项目用了自定义分页器类，需确保它继承自 Laravel 原生分页器，否则该设置无效
分页链接里加额外参数（比如带 category=tech）
默认分页链接只保留当前请求的 page 参数，其他查询参数（如 ?category=tech&sort=desc）会被丢掉。这不是 bug，是 Laravel 的默认行为——避免污染分页上下文。
要保留非分页参数，得显式告诉分页器哪些要透传。最常用的是 appends() 方法：
```php
$posts = Post::where('status', 'published')->paginate(10);
$posts->appends(request()->except('page'));
```-
appends()接收数组，键值对会自动拼进分页链接，比如生成?page=2&category=tech&sort=desc - 用
request()->except('page')比手写['category' => request('category')]更安全，尤其当参数可能为空或未提交时 - 注意：如果页面有表单 POST 提交，
request()拿不到 GET 参数，此时应从url()->current()+ 手动解析，或改用request()->query()
自定义分页器 URL 生成逻辑（比如加子目录 /admin/）
当 Laravel 部署在子路径（如 https://example.com/admin/），默认分页链接仍指向根路径 /posts?page=2，导致 404。这不是路由问题，而是分页器生成 URL 时没感知到子目录。
根本解法是覆盖 Laravel 的 URL 生成器行为，而不是硬编码链接：
- 在
AppServiceProvider::boot()中调用URL::forceRootUrl('https://example.com/admin') - 或者更灵活地：在 Nginx/Apache 配置中设好
APP_URL环境变量，Laravel 会自动读取 - 如果用了反向代理，确认
TrustedProxy中间件已启用，并设置了正确的FORWARDED_HOST和FORWARDED_PROTO，否则url()生成的协议和域名会错
分页器渲染时参数冲突（比如同时存在 page 和 p）
当手动在 URL 里混用多个分页参数（如 ?page=1&p=3），Laravel 会以 page 为准（除非你调过 Paginator::usePageName('p')），但模板渲染出的链接可能混乱：上一页还是 page=2，下一页却变成 p=4。
这种不一致通常源于两处未同步：
- 控制器里调用了
Paginator::usePageName('p')，但 Blade 模板里用了旧的$paginator->appends(['page' => 2]) - 前端 JS 动态翻页时，手动拼接 URL 仍用
page，而后端返回的分页器已切换为p - 解决办法：统一用
$paginator->resolveCurrentPage()获取当前页码，用$paginator->currentPageUrl()生成当前页链接，它会自动使用已设置的 page 名
分页不是“改个参数名就完事”，它横跨请求解析、实例构建、URL 生成、模板渲染四个环节。任一环脱节，链接就断或错位——尤其是多参数、子路径、前后端分离场景下，最容易漏掉 appends() 或 resolveCurrentPage() 这类隐性依赖。
