thinkphp中间件必须显式挂载、正确返回、按序执行，否则请求静默中断或参数丢失；需检查全局、路由级、控制器级三处注册点，handle中必须return $next($request)，避免重复读取php://input流，传参应通过request/response对象。
ThinkPHP 的中间件不是“写了就能用”的装饰器，它必须显式挂载、正确返回、按序执行，否则请求会静默中断或参数丢失——这是绝大多数线上故障的根源。
中间件没生效？先查这三处注册位置
中间件类文件存在 ≠ 被框架加载。ThinkPHP 只认三类注册点，漏掉任意一个都等于没写：
- 全局注册：修改
app/middleware.php（TP6/TP8）或config/middleware.php（TP6+ 多应用模式），返回数组，元素必须是完整类名字符串，如'\app\middleware\AuthCheck'；拼错命名空间或文件名不匹配（比如类名AuthCheck但文件叫authcheck.php）会导致Class not found且无明确提示 - 路由级注册：在
route/app.php中链式调用middleware()，支持传入类名字符串、别名（需在配置中映射）、或数组，例如Route::get('api/user', 'Api/User')->middleware('auth') - 控制器级注册：在控制器属性
$middleware中声明，支持条件过滤，如protected $middleware = [\app\middleware\CheckRole::class => ['only' => ['edit', 'delete']]
handle() 方法里不写 return $next($request) 就等于砍断请求链
ThinkPHP 中间件采用洋葱模型，$next($request) 是唯一通往控制器的入口。漏掉 return 或只调用不返回，PHP 默认返回 null，框架将其视为已结束响应，后续所有逻辑（包括控制器、视图、数据库连接释放）全部跳过。
- 常见错误写法：
$next($request);（没 return）、if (...) { return redirect(...); }（分支遗漏 return） - 正确结构必须保证所有执行路径都有返回值：
if (条件) { return response(); } return $next($request); - 后置逻辑（如日志、Header 注入）必须写在
$next($request)之后，且操作的是其返回的Response对象，例如$response = $next($request); $response->header('X-Processed', 'true'); return $response;
读不到 POST 数据？大概率是前面中间件已消耗了输入流
$request->post() 和 $request->input() 底层依赖 PHP 的 php://input 流，该流只能读取一次。一旦被任一中间件（包括框架内置的 ValidatePostSize 或你自写的日志中间件）调用过，后续再调就为空。
- 安全解法：统一改用
$request->param()，它由 ThinkPHP 缓存了原始解析结果，多次调用无副作用 - 若必须用原始流（如处理加密 payload），应在第一个中间件里一次性读取并存入 Request 属性，例如
$request->setParam('raw_body', file_get_contents('php://input'))，后续中间件通过$request->param('raw_body')获取 - 避免在多个中间件中重复调用
$request->post()—— 这不是 bug，是 HTTP 协议层限制
中间件传参和控制器通信的两种可靠方式
中间件与控制器之间不能靠全局变量或 session 临时传参，应使用框架认可的通道：
- 通过 Request 对象附加属性：
$request->data['user_info'] = $userInfo;，控制器中用$this->request->data['user_info']获取，干净且生命周期可控 - 通过 Response 对象注入上下文：
$response = $next($request); $response->withData(['quota_used' => 120]);，适合后置处理时向视图传递指标 - 禁止在中间件里直接修改
$_GET/$_POST—— 这会污染原始请求，导致验证、日志、缓存等环节行为异常
中间件的高阶难点不在语法，而在执行时机与数据所有权的边界感：谁读了流、谁设了 header、谁终结了响应——这些细节不厘清，加再多层中间件也只会让问题更隐蔽。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
