Route::resource() 不自动继承中间件，需显式绑定；正确方式为链式调用 middleware()、指定动作绑定或路由分组嵌套，并确保类名路径正确、handle() 方法显式 return、动作范围匹配。
Route::resource() 不会自动继承中间件
资源路由默认不挂载任何中间件，哪怕你在控制器构造函数里写了 $this->middleware()，或在 app/middleware.php 里注册了全局中间件，Route::resource('user', 'UserController') 生成的 index、show 等动作也完全不受影响。这不是 Bug，是 TP6+ 的设计逻辑：资源路由只负责批量注册路由规则，不参与中间件绑定流程。
常见错误写法：
Route::resource('user', 'UserController');
// 后面补一句 ->middleware(...)？没用，语法报错
正确做法必须显式为资源路由绑定中间件，有三种方式可选：
- 用
->middleware()链式调用（推荐）：Route::resource('user', 'UserController')->middleware(\app\middleware\Auth::class); - 对特定动作单独绑定：
Route::resource('user', 'UserController')->only(['index', 'show'])->middleware(\app\middleware\Stats::class); - 改用分组 + 资源路由嵌套（适合多动作差异化控制）：
Route::group(['middleware' => ['auth']])->resource('post', 'PostController');
中间件类名写错或未注册到路由链
即使你写了 ->middleware(\app\middleware\Auth::class)，如果类名路径不对，或该类根本没被框架加载，中间件照样静默跳过。最常踩的坑包括：
立即学习“PHP免费学习笔记（深入）”；
-
app/middleware.php里返回的是字符串'Auth'或Auth::class（漏了反斜杠），正确应为\app\middleware\Auth::class - 多应用模式下（如
app/admin），中间件写在根目录app/middleware.php，但路由实际走的是app/admin/route/app.php，此时应注册为\app\admin\middleware\Auth::class - 中间件类文件存在语法错误（比如
use漏了命名空间、handle()方法签名少参数），会导致框架加载失败，但不会报错，只是跳过执行
验证方法：在中间件 handle() 开头加一行 file_put_contents(runtime/log/mw.log', 'auth run'.PHP_EOL, FILE_APPEND);，访问资源路由后看日志有没有写入。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
handle() 末尾没 return 导致请求中断
这是最隐蔽的问题：中间件执行了，统计日志也写了，但控制器压根没跑，页面空白或返回 500。原因几乎全是 handle() 方法里漏了 return。
ThinkPHP 要求每个分支都显式返回一个 Response 实例：
- 放行必须写
return $next($request);，只写$next($request);是无效的（PHP 返回null，框架视为中断） - 拦截必须写
return json(['code' => 403]);或return redirect('/login');，不能用die、exit或throw new Exception() - 权限校验后忘记加
return，比如if (!Auth::check()) { abort(403); }——abort()本身不 return，必须改成return abort(403);
资源路由动作名和中间件逻辑不匹配
资源路由生成 7 个标准动作（index、create、store、show、edit、update、destroy），但你的中间件可能只适配其中一部分。例如：
- Auth 中间件检查登录态，但
create和index是公开页面，不该拦；结果你绑定了全部动作，导致游客打不开列表页 - CSRF 中间件用于
store/update，但误加到show上，GET 请求触发 token 校验失败 - 自定义中间件里调用了
param('id')，但index动作没有:id占位符，param()返回null，后续逻辑崩了
解决办法：用 only() 或 except() 精确控制动作范围，别图省事全绑。同时确认中间件内部逻辑是否兼容当前动作的请求方式（GET/POST）和参数结构。
资源路由中间件失效，90% 的问题不在“怎么写”，而在“有没有真正进到那条路由、有没有被框架当成有效中间件加载、有没有在最后一步把响应交出去”。调试时优先看日志写入、php think route:list 输出、以及响应头里有没有 X-Powered-By: ThinkPHP —— 这三样缺一不可。
