ThinkPHP路由中间件为什么不执行-ThinkPHP-PHP中文网

thinkphp路由中间件不执行的最常见原因是未显式绑定到路由链：必须用->middleware()方法手动挂载，且类名需用完整命名空间+::class；handle()方法末尾必须return响应实例，否则请求链中断。

thinkphp路由中间件为什么不执行

路由中间件没注册到路由链里

路由中间件不执行，最常见原因是根本没挂进请求链——ThinkPHP 不会自动把 app/middleware.php 里的类应用到路由上，它只管「应用级」请求（比如未匹配任何路由时的兜底行为）。你写了 Route::get('user', 'User/index')，但没加 ->middleware()，那中间件就完全不会触发。

必须显式绑定：

Route::get('user', 'User/index')->middleware(\app\middleware\Auth::class)
资源路由要单独绑： Route::resource('post', 'PostController')->middleware(\app\middleware\Auth::class)，不能指望控制器构造函数里的 $this->middleware() 自动生效
分组路由需在分组末尾链式调用：Route::group('api', function () { ... })->middleware(\app\middleware\Stats::class)，漏掉 ->middleware() 就等于没写

中间件类名或命名空间写错

字符串别名（如 'auth'）只有在 app/middleware.php 中注册了映射才有效；直接传类名字符串却漏了反斜杠，或大小写不一致，都会导致类加载失败、静默跳过。

常见错误写法：

Auth::class → 缺少根命名空间，应为 \app\middleware\Auth::class
'app\middleware\Auth' → 正确，但若文件实际在 app/admin/middleware/Auth.php（多应用模式），就得写 \app\admin\middleware\Auth::class
AuthMiddleware 或 AuthCheck → 类名不完整，框架找不到类

建议统一用完整命名空间 + ::class，避免别名映射带来的不确定性。

在SEO发布前，从路由清单生成XML网站地图和robots.txt

当代理已经知道网站路由或内容URL，并且在启动前需要有效的sitemap XML、sitemap索引或robots.txt引用时，请使用sitemap。这是一个发布构件技能，而不是爬虫或SEO平台。

下载

handle() 方法没 return Response 实例

这是最隐蔽的失效原因：中间件函数末尾没 return，PHP 默认返回 null，ThinkPHP 会直接中断整个请求链，后续中间件和控制器全被跳过——你的统计、鉴权逻辑可能执行了，但响应没发出去，前端卡住或报 500。

正确写法只有两种分支：

放行：必须写 return $next($request)，不能只写 $next($request)
拦截：必须返回 think\Response 实例，例如 return json(['code' => 401]) 或 return redirect('/login')，不能用 die、exit 或 echo
签名必须严格为 handle($request, \Closure $next)，少一个参数或类型不对，框架调用时直接报错或跳过

多应用模式下中间件路径和注册位置错乱

启用 app/multi_app 后，app/middleware.php 全局配置完全失效。每个应用（如 admin、api）必须有自己的中间件配置文件，且路径、命名空间、类文件位置三者必须严格对应。

典型错误场景：

在 app/middleware.php 里写了 \app\admin\middleware\Auth::class，但实际类文件放在 app/admin/middleware/Auth.php → 框架扫描不到，因为全局配置只加载 app/middleware/ 下的类
应该把中间件配置移到 app/admin/middleware.php，内容为 return [\app\admin\middleware\Auth::class];
路由定义仍需显式绑定：Route::rule('admin/:controller/:action', 'admin/:controller/:action')->middleware(\app\admin\middleware\Auth::class)

多应用下没有“全局中间件”概念，所有路由绑定都得落在对应应用的中间件配置范围内，否则就是无效空转。