API가 멈추는 것을 방지하세요: Laravel에서 비동기 이메일 전송

Source: Dev.to

동기식 메일 병목 현상

Smart Tech Devs에서 엔터프라이즈 B2B SaaS를 구축할 때, 환영 이메일, 비밀번호 재설정, 월간 청구서 등 트랜잭션 이메일을 보내는 것은 불가피합니다. 기본 Laravel 문서는 메일 전송을 매우 간단하게 보여줍니다:

Mail::to($user)->send(new InvoicePaid($invoice));

로컬 개발 환경에서는 문제없이 작동합니다. 하지만 프로덕션에서는 심각한 아키텍처 취약점이 됩니다. send() 메서드를 동기적으로 호출하면 현재 HTTP 요청 스레드가 멈춥니다. 서버는 네트워크 소켓을 열고 외부 SMTP 서버(Resend, Postmark, Mailgun 등)와 통신하며 TLS 핸드셰이크를 기다리고 데이터를 전송한 뒤 성공 응답을 기다립니다. 이 네트워크 홉은 쉽게 2~3초가 걸릴 수 있습니다. 사용자가 “청구서 결제” 버튼을 클릭했을 때 3초 지연은 시스템이 멈춘 듯한 느낌을 주며, API 처리량을 크게 감소시킵니다.

엔터프라이즈 솔루션: InteractsWithQueue & ShouldQueue

고성능 백엔드를 구축하려면 HTTP 응답 루프가 외부 서드파티 네트워크 요청에 의존해서는 안 됩니다. 메일을 비동기적으로 처리해야 합니다.

메일 전송을 즉시 동기 실행에서 격리된 백그라운드 큐로 옮기면, 사용자 요청은 데이터베이스 레코드를 저장하고 성공 UI를 반환하는 데 몇 밀리초만 걸리며, 전용 큐 워커가 백그라운드에서 네트워크 오버헤드를 처리합니다.

비동기 Mailable 설계

Laravel은 이 아키텍처 전환을 매우 우아하게 지원합니다. Mailable 클래스에 ShouldQueue 계약을 구현하기만 하면 됩니다.

invoice = $invoice;
    }

    public function envelope(): Envelope
    {
        return new Envelope(
            subject: 'Your Smart Tech Devs Invoice is Paid',
        );
    }

    public function content(): Content
    {
        return new Content(
            markdown: 'emails.invoices.paid',
        );
    }
}

큐 연결 최적화

메일 클래스가 ShouldQueue를 구현하면 Mail::to($user)->send(new InvoicePaid($invoice)); 호출이 더 이상 컨트롤러를 멈추게 하지 않습니다. 대신 Laravel은 모델 정보를 직렬화하고 이를 빠른 메모리 레이어(예: Redis)에 밀리초 이하의 시간 안에 즉시 저장합니다.

사용자 경험을 깔끔하게 유지하려면 메일 전송을 전용 백그라운드 큐 채널에 격리시켜야 합니다. 이렇게 하면 대량 이메일 발송이 재무 원장 계산과 같은 고우선순위 백그라운드 작업을 차단하지 않게 됩니다.

user())
    ->onQueue('emails') // 전용, 낮은 우선순위 큐 라인으로 라우팅
    ->send(new InvoicePaid($invoice));

엔지니어링 ROI

비동기 메일 처리로 API 응답 시간이 십자리 밀리초 수준으로 단축됩니다. 프레젠테이션 레이어를 외부 SMTP 인프라와 분리함으로써 서드파티 이메일 API가 다운될 때 발생할 수 있는 연쇄 타임아웃으로부터 애플리케이션을 보호합니다. 플랫폼은 완벽하게 반응성을 유지하고, 백그라운드 큐는 수백만 건의 트랜잭션을 원활히 처리하도록 확장됩니다.