thinkphp中间件不执行的核心原因是未注册、未挂载或handle方法未return响应实例；需检查app/middleware.php是否返回正确类数组、路由是否显式调用->middleware()、类名是否带完整命名空间，且handle末尾必须return $next($request)或response实例。
ThinkPHP中间件不执行，核心问题通常不是框架坏了，而是中间件根本没进请求链——要么没注册、要么没挂载、要么挂了但写法错导致静默跳过。排查要从加载入口开始，一层层往下盯。
检查 app/middleware.php 是否被正确加载
这是全局中间件的唯一注册入口，必须存在、必须返回数组、数组元素必须是可实例化的类名（带完整命名空间）。常见错误：
- 文件被删、改名，或内容变成
return null;、echo 'test';等非数组返回 - 多应用模式下（如启用
app/multi_app），误把中间件写在根目录app/middleware.php，实际应放在对应应用子目录，例如app/admin/middleware.php - 类名写成
Auth或AuthMiddleware，正确写法是\app\middleware\Auth::class或字符串'app\middleware\Auth'
确认路由中间件是否显式绑定
全局中间件只对「未匹配任何路由」的兜底请求生效；只要走具体路由（比如 Route::get('user', ...)），中间件就必须手动挂载：
- 单条路由：必须链式调用
->middleware(\app\middleware\Auth::class) - 资源路由：不能依赖控制器构造函数里的
$this->middleware()，得单独写Route::resource(...)->middleware(...) - 分组路由：要在分组闭包外链式调用
->middleware(...)，写在闭包里无效 - 别名写法（如
'auth'）需确保已在app/middleware.php中注册映射，否则直接跳过
验证 handle() 方法是否规范返回
这是最隐蔽的失效点：漏掉 return，PHP 默认返回 null，ThinkPHP 就中断整个请求链，后续全不执行，且无报错。
- 放行逻辑必须写
return $next($request);，不能只写$next($request); - 拦截逻辑必须返回
think\Response实例，例如return json(['code'=>401])或return redirect('/login') - 禁止使用
die、exit、echo或直接return []—— 这些都会让响应中断或格式错误
观察实际执行顺序与日志痕迹
光看代码容易误判，要确认中间件是否真跑到了：
- 开启中间件追踪：在
config/app.php中设'middleware_trace' => true，查看响应头X-Middleware-Stack字段，它会列出本次请求真实执行的中间件类名 - 在
handle()开头加一行\think\facade\Log::info('hit: '.get_class($this));，查日志确认是否触发 - 若某中间件完全没出现在
X-Middleware-Stack里，说明它压根没注册或没挂载成功，不用查内部逻辑
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
