ThinkPHP中间件需通过$request->param()、$request->header()、microtime(true)、session判断及设备指纹等获取完整请求上下文，并用trace_id串联请求链路，避免同步写日志阻塞性能。
中间件里怎么拿到完整请求上下文
ThinkPHP 的中间件默认只暴露 $request 和 $response，但用户行为轨迹需要更多：客户端 IP、UA、Referer、请求体（如 POST JSON）、路由参数、执行耗时、是否登录、用户 ID。光靠 $request->ip() 或 $request->url() 不够，容易漏掉关键链路信息。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在中间件
handle()开头就调用$request->except(['token', 'sign'])过滤敏感字段，再用$request->param()拿全部参数（含 GET/POST/Route） - 用
$request->header()提取X-Forwarded-For、User-Agent，别只信$request->ip() - 记录开始时间戳用
microtime(true)，别用time()，否则毫秒级耗时全归零 - 通过
$request->session()->get('user_id')获取登录态，但注意 session 未启动时会报错，加if ($request->session()->isStarted())判断
日志写入性能卡在哪
直接在中间件里用 Log::write() 或 file_put_contents() 写文件，高并发下会阻塞响应，尤其当磁盘 I/O 慢或日志量大时，接口 P99 耗时可能翻倍。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 禁用同步写日志，改用
think-queue推送日志消息到 Redis 队列，由独立消费者进程落库或写文件 - 若必须同步写，用
error_log($log, 3, '/path/to/access.log')，比file_put_contents()少一次 PHP 层 IO 封装 - 日志内容做最小化裁剪：去掉空参数、截断过长 UA（
mb_strcut($ua, 0, 200)）、不记录静态资源（if (preg_match('/\.(js|css|png|jpg|gif)$/i', $request->url())) return $next($request);） - 避免在中间件里查数据库记日志，比如查用户昵称——该字段应提前塞进 session 或缓存
如何关联同一用户的多次访问
单靠 session ID 不可靠：用户换设备、清缓存、跨域访问都会导致 session 断裂；用 cookie 的 device_id 又容易被伪造。真实场景中，一个用户从微信内嵌页 → H5 → App WebView，IP、UA、session 全变，但行为是连续的。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 生成轻量级设备指纹：拼接
$request->header('User-Agent').$request->ip().$request->header('Accept-Language')后取 md5，不依赖 JS，服务端可稳定生成 - 对已登录用户，强制以
user_id为主键；未登录则 fallback 到设备指纹，两者用不同字段存（如user_id和device_fingerprint），方便后续归并 - 在日志结构里加
trace_id字段，用uniqid('', true)生成，确保同一次页面跳转（含 AJAX）能串起来，比如首页加载时带trace_id=abc123，后续接口都透传它
为什么日志里看不到控制器和方法名
ThinkPHP 中间件执行时，路由尚未完全解析到具体控制器，$request->controller() 和 $request->action() 在中间件里返回空或默认值，不是 bug，是生命周期顺序决定的。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 不要在中间件里硬取 controller/action，改用
$request->rule()->getName()（需 TP6.1+），它返回的是路由定义名，比如'index/index' - 如果用了闭包路由或资源路由，
$request->rule()->getRule()可拿到原始规则字符串，配合正则提取模块/控制器/操作 - 更稳的方式：在
app/middleware.php中把日志中间件放到AppInit之后、BindModule之前，这样$request->dispatch()已完成，能安全调用$request->controller()
行为轨迹不是堆日志，而是让每条记录自带上下文、可追溯、不拖慢主流程。最常被忽略的是 trace_id 的透传和设备指纹的稳定性——没它们，再多日志也连不成线。
