ThinkPHP分页避坑：分页链接中多余的斜杠导致的路由错误-ThinkPHP-PHP中文网

分页url出现双斜杠导致404，是web服务器路径规范化与thinkphp路由匹配不一致所致；需确保base url干净、用框架自动拼接参数、路由改用正则约束变量、并收紧服务器配置。

thinkphp分页避坑：分页链接中多余的斜杠导致的路由错误

分页生成的 URL 里多出一个 /，点进去直接 404

这不是分页组件 bug，是 ThinkPHP 路由解析和 Web 服务器路径规范化共同作用的结果。比如分页链接生成为 /user/list//page/2（注意中间两个/），Nginx/Apache 通常会把//合并成单个/，但 ThinkPHP 的路由匹配器拿到的是合并后的 PATH_INFO，而你的路由规则写的是user/list/:page——它期待的是/user/list/2，不是/user/list/page/2，更不是/user/list//page/2被压成/user/list/page/2后还去匹配:page段。

常见诱因包括：

手动拼接分页 URL 时没清理末尾/，比如$base = url('user/list') . '/'再加page/2
使用url()生成基础路径后，又用str_replace()或substr()粗暴截断，留下残留/
自定义分页模板里写死了href="{:url('user/list')}//page/{$page}"这类双斜杠结构

ThinkPHP 分页类默认不处理斜杠合并，得自己干预

think\Paginator 本身只负责生成页码 HTML 和当前页数据，url() 构建逻辑由外部控制。它不会自动 trim 斜杠、也不会校验路径合法性。你传给它的url参数是什么样，它就原样拼进href里。

正确做法是确保传入分页构造器的 base URL 是「干净」的：

用url('user/list')获取路径，不要额外加/
如果必须拼接参数，用url('user/list', ['page' => $page])让框架自动组装，避免手拼
若需动态 base（比如带搜索条件），先用parse_url()拆解，再用http_build_query()重组 query，最后用implode('/', array_filter([$path, 'page']))拼路径段

路由规则里别硬写`page/:page`，改用变量约束

很多人写分页路由直接套用'user/list/page/:page' => 'User/list'，这会让page变成固定路径段，一旦前端多传一个/或服务端 PATH_INFO 被压缩，整个匹配就崩了。更健壮的方式是把分页参数作为可选变量，用正则收口：

Skill Weave Chains — 技能链路由引擎

开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。

下载

Route::get('user/list', 'User/list');
Route::get('user/list/:page', 'User/list')->pattern(['page' => '\d+']);

这样/user/list/2和/user/list//2（被服务器压成/user/list/2）都能命中；同时排除/user/list/abc这种非法值。关键点：

\d+比[:page]更安全，防止字符串注入
不要写user/list/:page/结尾带/，那会要求 URL 必须以/结尾，反而增加 404 概率
如果要支持?page=2查询参数形式，就别走路径参数，统一用input('page')读取，路由保持user/list最简

Apache/Nginx 配置里别让`//`偷偷溜进 PATH_INFO

即使 PHP 层逻辑没问题，Web 服务器也可能在转发前就把//吃掉或搞乱。尤其 Nginx 的try_files规则如果写成try_files $uri $uri/ /index.php?$query_string，遇到/user/list//page/2时，$uri 可能被截成/user/list/，导致 PATH_INFO 变成/page/2，完全错位。

检查并收紧入口规则：

Apache：确认.htaccess里没有重复重写，禁用DirectorySlash Off（避免目录跳转干扰）
Nginx：把try_files换成显式捕获全路径：try_files $uri $uri/ /index.php?s=$request_uri&$query_string;
开发时用php -S内置服务器？必须配 router.php，且里面要写if (is_file(__DIR__ . '/public' . $_SERVER['REQUEST_URI'])) { return false; }，否则//根本不会进路由