Laravel에서 큐에 쌓인 작업은 어떻게 동작하나요?

Question

Accepted Answer

Laravel의 **큐 시스템(queue system)**은 시간이 오래 걸리는 작업(이메일 전송, 파일 처리, 느린 API 호출)을 **백그라운드에서** 실행되도록 미룰 수 있게 하여, 사용자가 빠른 응답을 받게 합니다. 작업은 **Job**으로 캡슐화되어 큐에 푸시되고, 별도의 **워커(worker)** 프로세스에 의해 처리됩니다.

## 큐가 해결하는 문제

```text
인라인으로 수행되는 느린 작업은 사용자를 기다리게 하고 요청 타임아웃 위험이 있음:
  ✗ 이메일 전송, 이미지/비디오 처리, 리포트 생성, 느린 API 호출
  ✓ 큐에 넣기 → 사용자에게 즉시 응답 → 워커가 백그라운드에서 처리
```

## 작업 정의와 디스패치

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

public function handle(): void {
        // 느린 작업 — 웹 요청이 아닌 워커에서 실행됨
        $this->podcast->process();
    }
}
```

```php
// 작업 디스패치 — 큐에 푸시하고 즉시 반환
ProcessPodcast::dispatch($podcast);
ProcessPodcast::dispatch($podcast)->delay(now()->addMinutes(10));   // 지연
```

`ShouldQueue`를 구현하면 작업이 큐에 쌓일 수 있게 됩니다. `dispatch()`는 그것을 큐에 푸시하고 즉시 반환합니다 — 사용자는 작업을 기다리지 않습니다.

## 작업 처리 (워커)

```bash
php artisan queue:work          # 큐에 쌓인 작업을 처리하는 워커 실행
# 운영 환경에서: 워커를 감독되는 프로세스(Supervisor)로 실행하거나 Horizon 사용
```

별도의 **워커** 프로세스가 큐에서 작업을 꺼내 실행합니다. 큐 백엔드에는 Redis, 데이터베이스, SQS 등이 있습니다.

## 신뢰성 기능

```php
class ProcessPodcast implements ShouldQueue {
    public $tries = 3;             // 실패 시 최대 3번 재시도
    public $backoff = 60;          // 재시도 사이 60초 대기
    public function failed(Throwable $e): void { /* 최종 실패 처리 */ }
}
```

```text
✓ 백오프가 있는 재시도 (복원력), 실패한 작업 처리
✓ 영속성 (작업이 큐 백엔드를 통해 재시작에도 살아남음)
✓ Laravel Horizon → Redis 큐 모니터링/관리를 위한 대시보드
```

## 왜 중요한가

큐에 쌓인 작업은 반응적이고 확장 가능한 Laravel 애플리케이션을 구축하는 데 필수적입니다 — 느리거나 미뤄진 작업을 요청 주기에서 분리하는 것은 일반적이고 중요한 요구이며, Laravel의 큐 시스템은 이를 우아하게 만듭니다.

이를 이해하는 것은 가치가 있습니다. 시간이 오래 걸리는 작업(이메일 전송, 미디어 처리, 리포트 생성, 느린 외부 서비스 호출)을 인라인으로 수행하면 사용자가 기다리게 되고, 요청 타임아웃 위험이 있으며, 실패 시 작업을 잃는 반면 — **큐에 넣으면** 사용자에게 즉시 응답하면서 백그라운드 **워커**가 그것을 안정적으로 처리할 수 있기 때문입니다.

단순한 비동기 분리를 넘어, Laravel의 큐는 중요한 운영 기능을 제공합니다: **백오프가 있는 자동 재시도**(일시적 실패에 대한 복원력), **영속성**(작업이 큐 백엔드를 통해 크래시/재시작에도 살아남아 작업을 잃지 않음), 실패한 작업 처리, 지연 디스패치, 그리고 Horizon을 통한 모니터링.

작업을 정의(`ShouldQueue`)하고, 디스패치(즉시 반환)하며, 워커로 처리(`queue:work`, 운영 환경에서 감독됨)하고, 신뢰성 기능을 구성하는 방법을 이해하는 것은 무겁거나 미뤄진 작업을 우아하게 처리하는 애플리케이션을 구축하는 데 중요한 지식입니다.

반응적인 애플리케이션은 일상적으로 작업을 백그라운드로 분리해야 하고 — Laravel의 큐 시스템이 내장된 신뢰성으로 그것을 하는 우아하고 관용적인 방법이므로 — 작업과 큐를 숙달하는 것은 실제 워크로드에서 빠르고 안정적인 상태를 유지하는 운영 등급의 Laravel 애플리케이션을 구축하는 데 자주 관련되는 중요한 지식입니다.