thinkphp 8 可以用路由中间件生成请求 id，并把它写入正常响应的 x-request-id 头。客户端拿到这个值后，可以用它定位对应请求。

给每次请求生成独立标识

将类保存为 app/middleware/RequestId.php。此例使用服务端生成的十六进制 ID。

<?php
namespace app\middleware;

use Closure;
use think\Request;

class RequestId
{
    public function handle(Request $request, Closure $next)
    {
        $id = bin2hex(random_bytes(16));
        $response = $next($request);
        return $response->header(['X-Request-ID' => $id]);
    }
}

若服务端要按 ID 检索日志，应把同一 ID 加到应用日志上下文中。此例展示正常响应的响应头。

只在目标 API 路由组启用

在 route/app.php 中注册下面的示例组。若已有 API 路由组，可直接给它增加 middleware 调用。

Skill Weave Chains — 技能链路由引擎

开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。

下载

立即学习“PHP免费学习笔记（深入）”；

use think\facade\Route;

Route::group('api', function () {
    Route::get('ping', function () {
        return json(['ok' => true]);
    });
})->middleware(\app\middleware\RequestId::class);

需要异常响应也带 ID 时，要让异常处理层复用在调用下游前生成的标识。

连续两次请求核对响应头

替换端口为本地应用实际端口，然后执行。

curl -si http://127.0.0.1:8000/api/ping | grep -i '^x-request-id:'
curl -si http://127.0.0.1:8000/api/ping | grep -i '^x-request-id:'

两次响应都应有 32 位十六进制标识，且通常不同。若有反向代理，也要核对代理有没有改写或移除该响应头。