TP8中间件注册位置写错会直接静默跳过，只认app/middleware.php这一个全局入口且必须返回类名数组；写成config/middleware.php等其他路径则完全不加载，也不报错。
中间件注册位置写错，TP8直接静默跳过
TP8 只认 app/middleware.php 这一个全局注册入口，且该文件必须返回数组；写成 config/middleware.php、app/provider.php 或其他路径，框架完全不加载——不会报错，也不会提示，请求就当它不存在。
常见错误包括：
- 沿用 TP5.1 习惯，在
app/middleware.php里写return ['app\middleware\Auth']→ 缺少开头反斜杠，PHP 在当前命名空间下找类，报Class 'app\middleware\app\middleware\Auth' not found - 在 TP6 升级到 TP8 后，仍保留空的
app/middleware.php（只写了<?php return [];），但没删掉旧的全局配置逻辑，误以为“已注册” - 类文件名与类名不一致，比如文件是
app/middleware/jwtauth.php，但类定义为class JwtAuth→ PSR-4 加载失败，TP8 不兜底，静默跳过
路由级中间件传字符串别名，TP8 直接抛 InvalidArgumentException
TP6 和 TP8 都已废弃字符串别名绑定（如 ->middleware('auth')），但 TP8 更严格：只要传入非完整命名空间字符串或非 ::class 常量，就会在容器解析阶段抛出 InvalidArgumentException，而不是像 TP6 那样尝试 fallback。
正确写法只有两种：
立即学习“PHP免费学习笔记（深入）”；
->middleware(\App\Middleware\JwtAuth::class)->middleware([\App\Middleware\JwtAuth::class, \App\Middleware\RateLimit::class])
错误写法包括：
-
->middleware('app\middleware\JwtAuth')（缺少反斜杠） -
->middleware('JwtAuth')（无命名空间，TP8 不支持别名映射） -
->middleware(function ($req, $next) { ... })（TP8 禁用闭包形式，除非你在app/middleware.php中显式注册，但即便如此也不推荐）
中间件类没实现接口或没声明返回类型，TP8 反射失败后不报具体错
TP8 强制要求中间件类实现 think\contract\MiddlewareInterface，且 handle() 方法必须标注返回类型为 \think\Response。否则，容器在反射实例化时会失败，但错误信息常被吞掉，最终表现是中间件不执行、日志无记录、请求卡在某处。
典型问题：
- 从 TP6 复制过来的中间件，只写了
public function handle($request, \Closure $next)→ TP8 下因类型缺失触发TypeError，且框架不捕获，PHP 8.1+ 会直接中断 - 写了
implements MiddlewareInterface，但漏了use think\contract\MiddlewareInterface→ 类未找到，报Class 'MiddlewareInterface' not found - 返回值写成
return json(['code'=>0])或return redirect('/login')→ 这些不是\think\Response实例，TP8 不做自动封装，管道立即断裂
控制器级中间件用了 $middleware 属性，但 TP8 要求显式 add()
TP6 支持在控制器中定义 protected $middleware = [\App\Middleware\Auth::class];，TP8 已移除此语法糖。如果你还在用，该属性会被完全忽略——中间件不会注册，也不会报错。
TP8 正确做法是在控制器 initialize() 方法中调用：
public function initialize()
{
$this->middleware->add(\App\Middleware\Auth::class);
// 或带条件
$this->middleware->add(\App\Middleware\CheckRole::class, ['only' => ['edit', 'delete']]);
}
注意：$this->middleware 是 think\middleware\Middleware 实例，不是数组；直接赋值 $this->middleware = [...] 会覆盖对象，导致后续所有中间件注册失效。
最易被忽略的是：TP8 下中间件类名、文件名、命名空间三者必须完全一致，且大小写敏感；Linux 服务器上一个 Auth.php 写成 auth.php 就等于没这个类——连报错都看不到，只表现为“什么都没发生”。
