Laravel 中的队列任务是如何工作的？

Question

Accepted Answer

Laravel 的**队列系统**让你将耗时的任务（发送邮件、处理文件、调用缓慢的 API）延迟到**后台**运行，以便用户获得快速响应。任务被封装为**Jobs**，推送到队列上，并由独立的**worker**进程处理。

## 队列解决的问题

```text
Slow work done inline makes the user wait and risks request timeouts:
  ✗ sending emails, processing images/video, generating reports, calling slow APIs
  ✓ QUEUE it → respond to the user immediately → a worker handles it in the background
```

## 定义和分发任务

```php
<?php
// php artisan make:job ProcessPodcast
class ProcessPodcast implements ShouldQueue {
    public function __construct(public Podcast $podcast) {}

public function handle(): void {
        // the slow work — runs in a WORKER, not the web request
        $this->podcast->process();
    }
}
```

```php
// dispatch the job — pushes it onto the queue, returns IMMEDIATELY
ProcessPodcast::dispatch($podcast);
ProcessPodcast::dispatch($podcast)->delay(now()->addMinutes(10));   // delayed
```

实现 `ShouldQueue` 使任务可以被队列化。`dispatch()` 将其推送到队列并立即返回——用户不需要等待工作完成。

## 处理任务（workers）

```bash
php artisan queue:work          # run a worker to process queued jobs
# in production: run workers as a supervised process (Supervisor) or use Horizon
```

独立的**worker**进程从队列中取出任务并运行它们。队列后端包括 Redis、数据库、SQS 等。

## 可靠性功能

```php
class ProcessPodcast implements ShouldQueue {
    public $tries = 3;             // retry up to 3 times on failure
    public $backoff = 60;          // wait 60s between retries
    public function failed(Throwable $e): void { /* handle final failure */ }
}
```

```text
✓ Retries with backoff (resilience), failed-job handling
✓ Persistence (jobs survive restarts via the queue backend)
✓ Laravel Horizon → a dashboard for monitoring/managing Redis queues
```

## 为什么这很重要

队列任务对于构建响应式、可扩展的 Laravel 应用至关重要——将缓慢或延迟的工作从请求周期中卸载是一个常见的、重要的需求，Laravel 的队列系统使其变得优雅。

理解它很有价值，因为在线执行耗时的工作（发送邮件、处理媒体、生成报告、调用缓慢的外部服务）会让用户等待、冒请求超时的风险，并且如果失败则会丢失工作——而**队列化**它允许你立即响应用户，同时后台**worker**可靠地处理它。

除了简单的异步卸载，Laravel 的队列还提供重要的生产功能：**带退避的自动重试**（对瞬时故障的弹性）、**持久性**（任务通过队列后端在崩溃/重启后存活，工作不会丢失）、失败任务处理、延迟分发，以及通过 Horizon 进行监控。

理解如何定义任务（`ShouldQueue`）、分发任务（立即返回）、使用 workers 处理任务（`queue:work`、在生产中受监管），以及配置可靠性功能是构建优雅处理繁重或延迟工作的应用的重要知识。

由于响应式应用通常需要将工作卸载到后台——而且由于 Laravel 的队列系统是具有内置可靠性的优雅、惯用的方式——掌握任务和队列是构建在真实工作负载下保持快速和可靠的生产级 Laravel 应用的经常相关的、重要的知识。