Backend API Engineering for AI Engineers
Trang chủ / Module 9
📬 Module 9 / 14 · 1 tuần

Message Queue Fundamentals & RabbitMQ

Giao tiếp đồng bộ vs bất đồng bộ, mô hình exchange/queue/routing key của RabbitMQ, và các mức đảm bảo giao message.

RabbitMQMessage QueueDelivery Guarantee
📌 Vì sao module này quan trọng

Mọi lời gọi HTTP đồng bộ đều tạo ra sự phụ thuộc chặt (tight coupling) về thời gian: nếu service B chậm hoặc sập, service A gọi nó cũng bị ảnh hưởng ngay lập tức. Message queue phá vỡ sự phụ thuộc đó — cho phép A "gửi và quên" (fire-and-forget có kiểm soát), B xử lý khi sẵn sàng. Đây là công cụ nền tảng bắt buộc trước khi bàn tới Kafka (Module 10) hay bất kỳ pattern reliability nào (Module 12).

🎯 Mục tiêu học tập

  • Giải thích khi nào nên chọn giao tiếp bất đồng bộ (qua queue) thay vì đồng bộ (gọi HTTP trực tiếp)
  • Hiểu mô hình Exchange - Queue - Binding - Routing Key của RabbitMQ
  • Phân biệt 3 mức đảm bảo giao message: at-most-once, at-least-once, exactly-once
  • Thiết kế consumer xử lý message an toàn với cơ chế acknowledgement đúng cách

Đồng bộ vs Bất đồng bộ — khi nào tách rời thời gian xử lý

Gọi HTTP trực tiếp (đồng bộ) phù hợp khi cần kết quả ngay để trả lời client (ví dụ: kiểm tra tồn kho trước khi xác nhận đơn hàng). Nhưng nhiều thao tác không cần hoàn thành ngay trong vòng đời của request gốc — gửi email xác nhận, tạo báo cáo, đồng bộ dữ liệu sang hệ thống khác. Ép các thao tác này chạy đồng bộ khiến request chính chậm không cần thiết, và nếu service phụ (ví dụ email provider) sập, toàn bộ luồng chính bị ảnh hưởng theo dù về logic không liên quan. Đưa các thao tác này vào message queue giúp request chính trả lời nhanh, và việc xử lý phía sau có thể retry độc lập mà không ảnh hưởng trải nghiệm người dùng.

Mô hình RabbitMQ — Exchange, Queue, Binding, Routing Key

Producer không gửi message thẳng vào queue — nó gửi vào 1 Exchange, exchange quyết định route message tới queue nào dựa trên routing key và binding đã cấu hình.

Loại ExchangeCách route
DirectRoute tới queue có binding key khớp chính xác routing key
TopicRoute theo pattern (ví dụ order.*.created khớp order.vn.created)
FanoutBroadcast tới TẤT CẢ queue đã bind vào exchange này, bỏ qua routing key
# Fanout exchange — 1 sự kiện, nhiều consumer độc lập cùng nhận (giống pub/sub)
exchange.declare('order_events', type='fanout')
queue.declare('email_service_queue').bind('order_events')
queue.declare('inventory_service_queue').bind('order_events')
# Cả 2 service đều nhận được MỌI order event, xử lý độc lập theo nhu cầu riêng

3 mức đảm bảo giao message

Mức đảm bảoÝ nghĩaRủi ro
At-most-onceGửi 1 lần, không retry nếu lỗiCó thể mất message
At-least-onceRetry cho tới khi có acknowledgement thành côngCó thể nhận message TRÙNG LẶP — consumer phải tự xử lý idempotent
Exactly-onceĐảm bảo xử lý đúng 1 lầnCực kỳ khó đạt được thực sự trong hệ phân tán, thường chỉ là "effectively-once" nhờ kết hợp at-least-once + idempotency ở consumer

Trong thực tế, phần lớn hệ thống chọn at-least-once + idempotent consumer (liên hệ trực tiếp Idempotency Key ở Module 2) thay vì cố gắng đạt "exactly-once" thật sự — dễ triển khai đúng hơn và đạt hiệu quả tương đương.

Acknowledgement — consumer phải chủ động xác nhận đã xử lý xong

def on_message(channel, method, properties, body):
    try:
        process_order_event(body)
        channel.basic_ack(delivery_tag=method.delivery_tag)      # xác nhận thành công, xoá khỏi queue
    except RetryableError:
        channel.basic_nack(delivery_tag=method.delivery_tag, requeue=True)   # lỗi tạm thời, đưa lại vào queue
    except Exception:
        channel.basic_nack(delivery_tag=method.delivery_tag, requeue=False)  # lỗi vĩnh viễn, đưa sang Dead-letter Queue (Module 12)

Lỗi phổ biến nhất: dùng auto-ack (tự động xác nhận ngay khi nhận message, trước khi xử lý xong) — nếu consumer crash giữa chừng, message đã bị coi là "xử lý xong" và mất vĩnh viễn dù thực tế chưa xử lý. Luôn dùng manual ack, chỉ ack sau khi xử lý thành công thật sự.

🏋️ Bài tập thực hành

Xây luồng xử lý đơn hàng bất đồng bộ với RabbitMQ

Sửa API tạo đơn hàng (từ Module 2) để publish 1 event 'order.created' vào fanout exchange thay vì xử lý đồng bộ mọi việc. Xây 2 consumer độc lập: 1 gửi email xác nhận (giả lập), 1 cập nhật tồn kho — cả 2 cùng nhận event này. Triển khai đúng manual acknowledgement, giả lập lỗi tạm thời (network timeout) ở consumer email và chứng minh message được requeue và xử lý lại thành công. Giả lập consumer crash ngay sau khi auto-ack (không xử lý xong) và chứng minh message bị mất — sau đó sửa lại bằng manual ack để chứng minh message không bị mất.

📚 Tài nguyên học tập

✅ Tự đánh giá hoàn thành

  • Giải thích rõ khi nào nên chuyển 1 thao tác từ đồng bộ sang bất đồng bộ qua queue
  • Chọn đúng loại exchange (direct/topic/fanout) cho một bài toán routing cụ thể
  • Giải thích 3 mức đảm bảo giao message và vì sao at-least-once + idempotency là lựa chọn thực dụng nhất
  • Triển khai đúng manual acknowledgement, tránh mất message khi consumer crash giữa chừng