Dead letter queues in Spring Boot - Step-by-Step Execution

Concept Flow - Dead letter queues

Message Sent to Queue

↓

Message Processing Attempt

↓

Processing Success?

No→Message Rejected or Failed

↓

Message Sent to Dead Letter Queue

↓

Message Acknowledged

↓

Dead Letter Queue Holds Message

↓

Admin or System Reviews Message

Messages go to a queue, get processed, if processing fails they move to a dead letter queue for review.

Execution Sample

Spring Boot

rabbitTemplate.convertAndSend("mainQueue", message);

// Listener tries to process message
@RabbitListener(queues = "mainQueue")
public void process(String msg) {
  if (msg.contains("fail")) throw new RuntimeException("Fail");
  System.out.println("Processed: " + msg);
}

Send a message to mainQueue; if processing fails, message moves to dead letter queue.

Execution Table

Step	Action	Message Content	Processing Result	Queue State	Dead Letter Queue State
1	Send message	Hello	N/A	mainQueue: [Hello]	DLQ: []
2	Process message	Hello	Success	mainQueue: []	DLQ: []
3	Send message	fail this	N/A	mainQueue: [fail this]	DLQ: []
4	Process message	fail this	Failure	mainQueue: []	DLQ: [fail this]
5	Admin reviews	fail this	N/A	mainQueue: []	DLQ: [fail this]

💡 Processing stops after all messages are either processed or moved to dead letter queue.

Variable Tracker

Variable	Start	After Step 1	After Step 2	After Step 3	After Step 4	After Step 5
mainQueue	[]	[Hello]	[]	[fail this]	[]	[]
deadLetterQueue	[]	[]	[]	[]	[fail this]	[fail this]
processingResult	N/A	N/A	Success	N/A	Failure	N/A

Key Moments - 3 Insights

Why does the message 'fail this' end up in the dead letter queue?

Because processing threw an exception (Step 4 in execution_table), so the message was rejected and routed to the dead letter queue.

Does the dead letter queue automatically retry messages?

No, messages in the dead letter queue stay there until manually reviewed or reprocessed, as shown in Step 5.

What happens to messages processed successfully?

They are removed from the main queue and not sent to the dead letter queue, as seen with 'Hello' in Steps 2 and 3.

Visual Quiz - 3 Questions

Look at the execution_table, what is the state of mainQueue after Step 3?

A [fail this]

B [Hello]

C []

D [Hello, fail this]

💡 Hint

Check the 'Queue State' column for Step 3 in execution_table.

At which step does the message move to the dead letter queue?

A Step 2

B Step 4

C Step 3

D Step 5

💡 Hint

Look for 'Dead Letter Queue State' changes in execution_table.

If the message 'fail this' was processed successfully, how would the dead letter queue state change at Step 4?

A It would contain ['Hello']

B It would contain ['fail this']

C It would remain empty []

D It would contain both ['Hello', 'fail this']

💡 Hint

Refer to the processingResult and deadLetterQueue columns in execution_table at Step 4.

Concept Snapshot

Dead letter queues hold messages that fail processing.
Messages go to main queue first.
If processing fails, messages move to dead letter queue.
Dead letter queue messages need manual review.
Helps avoid losing failed messages silently.

Full Transcript

In Spring Boot messaging, messages are sent to a main queue. A listener tries to process each message. If processing succeeds, the message is removed from the queue. If processing fails, the message is sent to a dead letter queue. This queue holds failed messages for later review or reprocessing. For example, sending 'Hello' processes successfully and leaves the queue. Sending 'fail this' causes processing failure, so it moves to the dead letter queue. This system helps keep track of messages that could not be handled properly, preventing silent loss.