ThinkPHP 7 首页调用中间件传参失败，主因是路由未显式绑定参数、handle()方法签名缺失对应参数、或类名/命名空间书写错误（如缺开头反斜杠），三者任一缺失均导致参数无法传递。
ThinkPHP 7 首页调用中间件时传参失败，基本就是路由没绑参数、中间件没接参数、或类名/命名空间写错这三类问题——不是框架不支持，而是调用链断在了某一处。
路由注册时没带参数，中间件根本收不到
TP7 的中间件参数必须通过路由显式传递，app/middleware.php 全局注册不支持传参。首页如果是 Route::get('/', ...) 这种写法，必须手动加 ->middleware() 并附参数：
- 错误写法：
Route::get('/', 'IndexController@index');—— 中间件不会执行，更别说传参 - 正确写法：
Route::get('/', 'IndexController@index')->middleware(\app\middleware\AuthCheck::class, 'home'); - 如果首页走的是默认路由（比如
index模块的index方法），也要在对应路由分组里补上->middleware(...)，不能依赖“自动触发”
中间件 handle() 方法签名不匹配，参数被忽略
TP7 要求带参中间件的 handle() 必须严格接收第三个参数（及以后），且类型提示可选但变量名必须对得上。漏掉参数声明，值就直接丢弃：
- 错误写法：
public function handle($request, \Closure $next) { ... }—— 即使路由传了'admin'，这个字符串也不会进函数 - 正确写法：
public function handle($request, \Closure $next, $role) { ... }或public function handle($request, \Closure $next, string $role) { ... } - 多个参数时顺序必须和路由传入一致：
->middleware(AuthCheck::class, 'admin', 'read')对应handle($request, $next, $role, $scope)
中间件类名或命名空间写错，参数根本没进实例
TP7 路由解析中间件时，会按字符串去容器里找类。名字不对，就会 fallback 到无参默认构造，参数自然失效：
立即学习“PHP免费学习笔记（深入）”；
- 错误写法：
->middleware('AuthCheck', 'admin')—— 如果没在config/middleware.php里配置别名映射，会报类不存在 - 更常见错误：
->middleware(app\middleware\AuthCheck::class, 'admin')—— 少了开头的反斜杠，PHP 当成相对命名空间，加载失败 - 正确写法：
->middleware(\app\middleware\AuthCheck::class, 'admin')（注意开头\） - 验证方式：在中间件
handle()开头加var_dump(get_class($this)); die;，看是否真进了这个类
首页被静态缓存或 Swoole 缓存绕过中间件
TP7 默认启用视图缓存，首页若命中缓存，整个请求生命周期会被截断——中间件、控制器、模板渲染全跳过，参数当然传不进去：
- 开发阶段先关掉：
config/template.php中设'cache' => false - 用了
think-swoole？检查是否启用了static_handler或enable_static_handler，它会把/直接返回静态文件，不进 PHP 流程 - Nginx 层有没有配
try_files $uri /index.php?$query_string;？缺这句，某些路径可能 404 或走错入口
最常被忽略的是：首页路由看似简单，反而最容易被当成“默认行为”而漏掉中间件绑定；一旦加上 ->middleware()，参数传递就和其他路由完全一致——没有特殊逻辑，只有明确注册和严格签名。
