Laravel怎么实现队列任务执行上下文追踪链路ID_Laravel全链路日志串联【详解】-Laravel-PHP中文网

laravel队列任务中request_id丢失是因为其在新进程执行，不继承http请求生命周期；解决方法是将trace_id显式传入任务构造函数并在日志处理器中通过全局变量或monolog注入，确保跨任务和跨服务链路追踪。

laravel怎么实现队列任务执行上下文追踪链路id_laravel全链路日志串联【详解】

为什么 Laravel 队列任务里 `request_id` 会丢？

因为队列任务在新进程（如 php artisan queue:work）中执行，不继承 HTTP 请求生命周期，request()->id 或中间件注入的上下文变量全失效。你看到日志里一堆 request_id: null 或随机 UUID，不是没传，是根本没带进来。

核心解决思路：把链路 ID 主动“塞进”任务载荷，而不是依赖运行时环境。

HTTP 请求中生成唯一 trace_id（例如用 Str::uuid()），存入 Request 或 IlluminateSupportFacadesLog 的上下文
投递队列任务时，显式将 trace_id 作为参数传入构造函数或 dispatch() 方法
任务类内部不再查 request()，而是从自身属性或 $this->trace_id 读取

`dispatch()` 时怎么安全透传 `trace_id`？

别用闭包或匿名函数传参——序列化后上下文丢失；也别依赖全局静态变量，多 worker 并发下会串。

推荐两种可靠方式：

通过任务构造函数注入：
```
SendNotification::dispatch($user, $trace_id);
```
并在 SendNotification 类中声明 public function __construct($user, $trace_id) { $this->trace_id = $trace_id; }
用 onQueue() + 自定义 with()` 链式调用（需重写 __serialize()）不如构造函数直接，但若已用 Job 基类，可在 handle() 开头统一从 $this->job->getRawBody() 解析——不推荐，耦合 RabbitMQ/Redis 协议细节

注意：Laravel 10+ 的 dispatchSync() 会保留当前上下文，但仅用于测试或极低并发场景，不能替代异步链路追踪。

日志里怎么让 `trace_id` 自动出现在每条记录中？

靠改 config/logging.php 的 tap 配置 + 自定义 Monolog 处理器最稳，不侵入业务代码。

laravel-specialist

精通 Laravel 10+，遵循现代 PHP 实践的 Laravel 专家。擅长优雅语法、Eloquent ORM、队列系统及企业级特性...

下载

新建一个 app/Logging/TraceIdProcessor.php：

use MonologProcessorProcessorInterface;
class TraceIdProcessor implements ProcessorInterface
{
    public function __invoke(array $record): array
    {
        $record['extra']['trace_id'] = request()->hasHeader('X-Trace-ID') 
            ? request()->header('X-Trace-ID') 
            : (app()->runningInConsole() && isset($GLOBALS['current_trace_id']) 
                ? $GLOBALS['current_trace_id'] 
                : 'unknown');
        return $record;
    }
}

然后在队列任务的 handle() 开头手动设一次全局变量：

$GLOBALS['current_trace_id'] = $this->trace_id;

不要用 Log::withContext() 每次手动塞，容易漏、难维护
避免在 AppServiceProvider 中监听 JobProcessing 事件去设上下文——事件触发时机晚于日志初始化，首条日志仍无 trace_id
如果你用的是 stack 日志通道，确保所有子通道（single, daily）都经过同一 tap

Redis 队列里能看到 `trace_id` 吗？怎么看？

能，但得知道它在哪——Laravel 默认把整个任务对象序列化成 JSON 存进 Redis 的 queues:default 列表，trace_id 就在 data.command 字段里（Laravel 9+ 是 data.job）。

调试时可以直接用 redis-cli 查：

LRANGE queues:default 0 1

你会看到类似：

{"uuid":"xxx","displayName":"App\Jobs\SendNotification","job":"Illuminate\Queue\CallQueuedHandler@call","maxTries":1,"delay":null,"timeout":60,"data":{"command":"O:27:"App\Jobs\SendNotification":3:{s:5:"trace_id";s:36:"123e4567-e89b-12d3-a456-426614174000";..."}}