控制器中间件局部不生效，根本原因在于注册方式、作用范围或执行时机导致链路中断；ThinkPHP 6.1 不支持 priority 序号调整优先级，其执行顺序由注册位置和绑定方式决定，且默认固定在路由中间件之后、控制器方法之前。
控制器中间件局部不生效，通常不是“调用顺序号”本身可调整的问题，而是注册方式、作用范围或执行时机导致的链路中断。ThinkPHP 6.1 中没有类似 Laravel 的 priority 数字序号机制来手动指定控制器级中间件的执行优先级；它的顺序由**注册位置和绑定方式**决定，且控制器中间件默认插入在路由中间件之后、控制器方法执行之前——但这个位置是固定的，不能通过“改序号”动态偏移。
确认是否真用了控制器级中间件绑定
控制器中间件需显式声明，不是自动加载：
- 在控制器类中定义
middleware属性（数组形式），例如：protected $middleware = [\app\middleware\Auth::class]; - 或在构造函数中调用
$this->middleware()，例如：$this->middleware(\app\middleware\Auth::class)->except(['login', 'register']); - 若只在
app/middleware.php注册了该类，但控制器里没声明，它对当前控制器完全不生效
检查中间件是否被条件过滤掉
控制器中间件支持 only 和 except 过滤，容易误配导致“局部不生效”：
-
$this->middleware(Auth::class)->only(['index', 'view'])：仅对 index/view 方法生效，其他方法跳过 -
$this->middleware(Auth::class)->except(['edit'])：edit 方法不执行，其余都执行 - 拼写错误（如方法名大小写不符）、方法不存在、或用了未定义的魔术方法（如 __call）都会让过滤逻辑静默跳过
避免与路由中间件冲突或重复拦截
控制器中间件会叠加在路由中间件之后执行，但如果前面某层已 return 响应（如登录校验失败直接 redirect），后续中间件包括控制器级的都不会再运行：
立即学习“PHP免费学习笔记（深入）”；
- 检查前置中间件（如全局 Auth 或路由级权限中间件）是否提前终止了请求链
- 控制器中间件无法“插队”到更前的位置——想让它更早执行，应改用路由级绑定：
Route::get('user/profile', 'User/profile')->middleware(\app\middleware\Auth::class); - 若需强制追加到整个中间件栈末尾（比如日志记录），用
appendMiddleware()替代middleware()
验证实际执行链是否包含该中间件
启用中间件追踪，看请求到底走了哪些层：
- 在
app/middleware.php中临时开启调试：'middleware_trace' => true,（需确保配置已加载） - 发起请求后查看响应头：
X-Middleware-Stack字段，它会列出完整执行顺序，含控制器中间件类名 - 若该中间件未出现在列表中，说明根本没注册进当前请求链，重点排查控制器属性定义位置、命名空间是否正确、类文件是否存在
