TP8中间件handle()方法必须声明返回类型为\think\Response，参数须为\think\Request和\Closure且顺序不可换，需use引入命名空间，提前终止须显式返回Response实例。
中间件 handle() 方法必须声明返回类型
TP8 强制要求中间件实现 think\contract\MiddlewareInterface，且 handle() 方法的返回值必须是 \think\Response。不加类型声明或写错类型，会导致运行时异常或响应被静默丢弃。
- 错误写法：
public function handle($request, \Closure $next)—— 缺少返回类型，PHP 8+ 下触发TypeError或框架无法识别中间件逻辑 - 正确写法：
public function handle(\think\Request $request, \Closure $next): \think\Response - 必须显式引入命名空间：
use think\Request;和use think\Response;，否则\think\Response会被解析为当前命名空间下的类 - 若中间件需提前终止流程（如鉴权失败），必须显式返回
response()->fail(...)或redirect(...)等构造出的\think\Response实例，不能只写return false或exit
参数类型声明顺序和可空性要严格匹配
handle() 的两个参数不是随意写的：第一个必须是 \think\Request 类型，第二个必须是 \Closure 类型，且不能交换顺序——框架底层按位置调用，顺序错会导致 ArgumentCountError 或类型不匹配。
-
\think\Request $request：不可为空，不能加?；传入非Request实例会直接报TypeError -
\Closure $next：也不可为空；框架保证它一定存在，$next($request)是继续执行后续中间件或控制器的唯一方式 - 不要尝试加默认值，例如
\Closure $next = null—— 这会破坏契约，导致$next变成null而不是闭包，调用时崩出TypeError: Call to a member function ... on null
为什么不能用 $request->param() 之类的方法在 handle() 里取参？
因为 handle() 执行时机早于路由解析和参数绑定，此时 $request->param() 返回的是空数组或未解析的原始数据，不是你预期的 URL 路径变量或表单字段。
- 想读路径参数（如
/user/:id中的id）？得用$request->route('id')，而不是$request->param('id') - 想读请求头？用
$request->header('Authorization') - 想读原始 body？用
$request->getRawContent()，但注意 POST 表单已被消耗，重复调用会返回空字符串 - 依赖
input()或$this->request在中间件里基本无效——它们是控制器层的封装，中间件里没初始化$this
常见报错和修复点
部署后中间件突然不生效、页面白屏或返回 500，大概率是 handle() 类型声明或返回值出问题。
立即学习“PHP免费学习笔记（深入）”；
-
Fatal error: Uncaught TypeError: app\middleware\Auth::handle(): Return value must be of type think\Response, null returned→ 忘了return，或写了return $next($request);但$next($request)返回的不是\think\Response（比如下游中间件没按规范返回） -
Class 'think\Response' not found→ 没加use think\Response;，或写成了use think\Response as Response;却忘了在返回类型里用别名 - 中间件执行了但后续控制器收不到参数 → 在中间件里误调用了
$request->post()或$request->param()并修改了内部状态，导致控制器层二次读取失败（PHP 的 input 流只能读一次）
handle() 的返回值类型不是“建议”，而是运行时强制校验项，哪怕只漏一个反斜杠（think\Response 写成 think\response），也会让整个请求链路中断。 
