中间件必须显式返回响应对象才能终止流程，return redirect()无效是因为未返回think\Response实例；正确做法是return response()->redirect('/login')或抛出HttpResponseException。
中间件不是控制器，return 语句不会自动终止请求流程，必须显式返回响应对象或抛出 HttpResponseException。
中间件里写 return redirect() 为什么没跳转？
这是最常踩的坑：你以为写了 return redirect('/login') 就能中断流程，但框架只把它当做一个返回值交给调度器，后续中间件和控制器照常执行。
- 中间件的
handle()方法必须返回一个think\Response实例，否则框架默认忽略返回值，继续调用$next($request) -
redirect()、json()、view()等 Facade 方法返回的才是合法响应对象，直接return它们才有效 - 别写
return 'hello';或return ['code'=>0];—— 这些不是响应对象，框架不会处理成 HTTP 响应 - 调试时可在中间件开头加
throw new \Exception('in middleware');快速验证是否执行到这一步
想实现类似控制器 beforeAction 的拦截，该用 $next() 还是 throw？
ThinkPHP 没有 beforeAction 这个概念，但你可以用中间件模拟。关键在于“中断方式”选哪种：
- 用
return response()->json(['code'=>401])：走正常响应流程，不触发异常处理器，适合简单拦截（如维护模式、IP 黑名单） - 用
throw new HttpResponseException(response()->json(['code'=>403]))：走异常流程，会进App\ExceptionHandle::render()，适合需要统一日志、监控、告警的业务拦截（如权限拒绝、token 过期） - 注意：
HttpResponseException构造函数第一个参数**必须是Response对象**，传数组或字符串会报错 - 如果重写了
ExceptionHandle::render()，要确认它没有把你的响应结构改掉（比如自动包了一层data）
中间件中访问用户信息失败：Call to a member function user() on null
这不是代码写错了，而是中间件注册顺序不对 —— $request->user() 是由 AuthMiddleware 注入的，不是 Request 自带能力。
立即学习“PHP免费学习笔记（深入）”；
- 检查
app/middleware.php数组顺序：你的权限中间件必须放在AuthMiddleware之后，例如['AuthMiddleware', 'PermissionMiddleware'] - 路由分组中注册时也要注意顺序：
Route::group(['middleware'=>['auth','permission']]) - 更稳妥的方式是绕过
$request->user()，改用auth('api')->check()和auth('api')->id()，它们不依赖 Request 绑定 - 若必须用
$request->user()，先在中间件顶部加判空：if (!$request->has('user')) { return response()->json(['msg'=>'未登录'], 401); }
中间件执行顺序混乱导致逻辑失效
ThinkPHP 中间件是严格按数组索引顺序执行的，“洋葱模型”意味着越靠前的中间件越早进入、越晚退出。顺序错一点，整个拦截逻辑就崩了。
- 全局中间件（
app/middleware.php）优先级最高，其次是应用/路由/控制器中间件 - 多应用模式下，
app/middleware.php不生效，得去对应应用目录（如app/api/middleware.php）配 - 闭包中间件必须显式写成
function ($request, \Closure $next) { ... }，漏掉$next参数或忘记return $next($request)会导致后续全部中断 - 调试顺序建议：在每个中间件
handle()开头加Log::info('middleware: xxx');，看日志输出顺序是否符合预期
真正容易被忽略的是中间件与生命周期的耦合点：比如在全局中间件里读 $request->param() 可能为空，因为参数解析发生在路由匹配后；又比如 Session 在某些驱动下尚未初始化，session('user_id') 返回 null。这些不是 bug，是设计使然 —— 中间件越前置，能用的东西越少。
