thinkphp 8 的中间件签名报错是因为框架不再支持旧版 handle 方法的单参数调用方式，必须改为接收 $request 和 $next 两个参数。将自定义中间件的 handle 方法签名修改为 public function handle(request $request, closure $next) 即可解决该问题。
如何正确定义 ThinkPHP 8 中间件的入口方法？
在 ThinkPHP 8 中，所有中间件类都必须实现 MiddlewareInterface 接口，且核心处理逻辑集中在 handle 方法中。该方法必须接受一个 hink
equest 对象和一个 PHP 闭包 Closure（代表后续中间件或控制器逻辑）。如果只保留原来的单个参数，PHP 会抛出类型不匹配错误。修改后的标准写法如下：
namespace app\middleware;
use think\Request;
use Closure;
class CheckAuth {
public function handle(Request $request, Closure $next) {
// 执行前置逻辑，例如检查 Token
if (!$request->header('token')) {
return json(['code' => 401, 'msg' => '未授权']);
}
// 继续执行后续中间件或控制器
return $next($request);
}
}
运行上述代码时，若请求头缺少 token，程序直接返回 JSON 响应并终止；若存在 token，则通过 $next($request) 将请求传递给下一个环节。这种双参数结构确保了请求生命周期管理的清晰性。
为什么旧版单参数签名会导致 TypeError？
ThinkPHP 5.x 及更早版本中，中间件通常继承自基类或使用单参数 handle($request)，框架内部通过反射或固定调用方式注入参数。升级到 ThinkPHP 8 后，底层调度器严格遵循 PSR-15 风格或框架自定义的双参数契约，强制要求第二个参数为 Closure。当开发者沿用旧代码时，框架尝试传入两个参数，但方法定义仅接受一个，从而触发 TypeError: Too few arguments to function 或类似签名冲突错误。
修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
// 错误示例：ThinkPHP 8 下会报错
public function handle(Request $request) {
return $next($request); // $next 未定义
}
// 正确示例：显式声明 Closure
public function handle(Request $request, Closure $next) {
return $next($request);
}
对比可见，旧版写法不仅参数数量不足，还试图访问未定义的 $next 变量。新版必须显式声明 Closure $next，并通过调用它来推进请求流。这是从“被动接收”到“主动链式传递”的架构转变，确保每个中间件都能明确控制是否继续执行后续逻辑。
如果在 handle 中提前返回响应，$next 还会被调用吗？
不会。在 ThinkPHP 8 的中间件机制中，$next($request) 是一个惰性调用点。只有当代码执行到该行时，才会触发后续中间件或控制器的执行。如果在调用 $next 之前直接 return 了一个响应对象（如 json()、view() 等），则整个请求链会立即中断，后续的中间件和控制器都不会被执行。这在实现权限校验、日志记录或缓存拦截时非常有用，可以基于条件决定是否放行请求。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
