thinkphp中间件handle方法必须接收$request和$next两个参数，$request不可变需用with()/merge()修改，$next必须显式调用且仅一次，未捕获异常会中断链路，返回值为响应对象需判型处理。
中间件 handle 方法必须接收两个参数
ThinkPHP 的中间件 handle 方法签名是固定的：第一个参数是 $request（think\Request 实例），第二个是 $next（闭包，用于调用后续中间件或控制器）。漏掉任一参数，运行时会直接报错 Too few arguments to function。
常见错误写法：public function handle($request)（少 $next）、public function handle($request, $response)（错把 $next 当成响应对象）。
-
$next不是think\Response，不能直接 return 或赋值给变量后返回 - 必须显式调用
$next($request)才能继续执行链路；不调用就中断，且不会自动返回响应 - 若需提前响应（如鉴权失败），应 return 一个
think\Response实例，例如return response('Forbidden', 403)
在 handle 里修改请求参数要调用 with() 或 merge()
ThinkPHP 的 $request 是不可变对象（immutable），直接改 $request->param['xxx'] 或 $request->get['xxx'] 无效。想注入或覆盖参数，必须用 with() 或 merge() 构造新请求对象。
比如中间件中想统一添加 trace_id：
$newRequest = $request->with(['trace_id' => uniqid('t_')]);
return $next($newRequest);
-
with()接收关联数组，会覆盖同名参数；merge()则是浅合并，适合追加而非覆盖 - 注意：修改
post、file等字段需用对应方法如withPost()，不能全靠with() - 如果中间件后还有其它中间件依赖原始参数，这种修改会影响后续逻辑——得确认是否符合预期
异常未捕获会导致整个中间件链崩掉
在 handle 方法里抛出未捕获的异常（比如调用了一个不存在的配置项或数据库查询失败），ThinkPHP 不会自动兜底，而是直接终止中间件链并输出错误页（开发环境）或 500（生产环境）。
- 建议对关键外部依赖（如 Redis、HTTP 客户端调用）做 try/catch，并 return 合理响应，例如
return json(['code' => 500, 'msg' => 'service unavailable']) - 不要依赖全局异常处理来“救”中间件里的错误——它发生在请求分发前，很多全局钩子尚未激活
- 调试时可在
handle开头加dump(__METHOD__); exit;快速定位是否执行到该中间件
多个中间件顺序执行时，$next($request) 的返回值就是下游结果
$next($request) 的返回值类型取决于链路末端：可能是 think\Response（控制器正常返回）、think\response\Json、甚至是你前面某个中间件提前 return 的响应对象。它不是固定格式，不能假设为数组或字符串。
- 如果你想在响应发出前统一加 Header，得先判断返回值是否为响应对象：
if ($next($request) instanceof Response) - 更稳妥的做法是：只在中间件末尾处理响应，即
$response = $next($request); $response->header(...); return $response; - 切勿对
$next($request)做多次调用——它只应被调用一次，重复调用可能触发重复 DB 查询或重复日志记录
handle 看似简单，但参数约束、请求不可变性、异常传播路径和响应类型不确定性，这四点最容易在上线后暴露问题。尤其是团队协作时，有人顺手在中间件里 echo 或 var_dump，会直接破坏响应体结构，连 JSON 都变不合法。php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
