Message Acknowledgements & Durability
Ensure message reliability by implementing manual acknowledgements and making messages and queues durable. Prevent data loss in case of consumer or broker failures.
Message Acknowledgements & Durability is a free RabbitMQ Messaging & Async Systems lesson on CoddyKit — lesson 3 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the RabbitMQ Messaging & Async Systems learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.
Introduction to Reliability
In distributed systems, ensuring messages are processed reliably is paramount. What happens if a server crashes? Or if a message consumer fails mid-processing?
This lesson explores two key mechanisms in RabbitMQ to prevent data loss and ensure reliability: Message Acknowledgements and Durability for both messages and queues.
What are Message Acknowledgements?
When a consumer receives a message, it needs to tell RabbitMQ that it has successfully processed it. This confirmation is called an Acknowledgement (or 'ack').
- Without Acks: If a consumer crashes before processing, the message is lost.
- With Acks: If a consumer crashes, RabbitMQ knows the message wasn't acknowledged and can redeliver it to another consumer.
Automatic vs. Manual Acknowledgements
RabbitMQ supports two modes for acknowledgements:
- Automatic (Auto-ack): RabbitMQ considers a message acknowledged as soon as it's delivered to the consumer. This is simple but risky, as messages can be lost if the consumer crashes immediately after receiving but before processing.
- Manual (Explicit Ack): The consumer explicitly sends an acknowledgement back to RabbitMQ *after* it has successfully processed the message. This is the recommended approach for reliable processing.
Implementing Manual Acknowledgements
Let's see how to implement manual acknowledgements in a Java consumer. We use channel.basicAck() after our message processing logic completes.
Try running this example. The consumer will acknowledge the message after a short delay.
import com.rabbitmq.client.Channel;
import com.rabbitmq.client.Connection;
import com.rabbitmq.client.ConnectionFactory;
import com.rabbitmq.client.DeliverCallback;
public class ConsumerAck {
private final static String QUEUE_NAME = "ack_queue";
public static void main(String[] argv) throws Exception {
ConnectionFactory factory = new ConnectionFactory();
factory.setHost("localhost");
Connection connection = factory.newConnection();
Channel channel = connection.createChannel();
// Declare a non-durable queue
channel.queueDeclare(QUEUE_NAME, false, false, false, null);
System.out.println(" [*] Waiting for messages. To exit press CTRL+C");
// Set prefetch count to 1 for fair dispatch (covered in Work Queues)
channel.basicQos(1);
DeliverCallback deliverCallback = (consumerTag, delivery) -> {
String message = new String(delivery.getBody(), "UTF-8");
System.out.println(" [x] Received '" + message + "'");
try {
Thread.sleep(1000); // Simulate work
} catch (InterruptedException e) {
Thread.currentThread().interrupt();
}
channel.basicAck(delivery.getEnvelope().getDeliveryTag(), false);
System.out.println(" [x] Done and Acknowledged");
};
// false means manual acknowledgement
channel.basicConsume(QUEUE_NAME, false, deliverCallback, consumerTag -> {});
// Producer to send a message (for testing)
Channel producerChannel = connection.createChannel();
producerChannel.queueDeclare(QUEUE_NAME, false, false, false, null);
producerChannel.basicPublish("", QUEUE_NAME, null, "Hello Ack!".getBytes("UTF-8"));
System.out.println(" [x] Sent 'Hello Ack!'");
}
}Handling Failed Message Processing
What if a consumer fails to process a message? Instead of acknowledging it, you can negatively acknowledge it:
channel.basicNack(deliveryTag, multiple, requeue): Rejects one or more messages.channel.basicReject(deliveryTag, requeue): Rejects a single message.
The requeue parameter is crucial. If true, the message is sent back to the queue for another consumer. If false, it's discarded or sent to a Dead Letter Exchange (DLX), which we'll cover in a later lesson.
What is Message Durability?
Acknowledgements handle consumer failures, but what about the RabbitMQ broker itself? If the server crashes or restarts, what happens to messages in the queues?
Message Durability ensures that messages persist on disk and survive a broker restart. This means critical messages are never lost, even if the RabbitMQ server goes down unexpectedly.
Making Messages Persistent
To make a message durable, you need to mark it as 'persistent' when publishing. This tells RabbitMQ to write the message to disk.
We use MessageProperties.PERSISTENT_TEXT_PLAIN for this.
import com.rabbitmq.client.Channel;
import com.rabbitmq.client.Connection;
import com.rabbitmq.client.ConnectionFactory;
import com.rabbitmq.client.MessageProperties;
public class ProducerPersistent {
private final static String QUEUE_NAME = "persistent_queue";
public static void main(String[] argv) throws Exception {
ConnectionFactory factory = new ConnectionFactory();
factory.setHost("localhost");
try (Connection connection = factory.newConnection();
Channel channel = connection.createChannel()) {
// Declare a durable queue first!
channel.queueDeclare(QUEUE_NAME, true, false, false, null);
String message = "Hello Persistent Message!";
channel.basicPublish(
"",
QUEUE_NAME,
MessageProperties.PERSISTENT_TEXT_PLAIN, // Mark message as persistent
message.getBytes("UTF-8")
);
System.out.println(" [x] Sent '" + message + "'");
}
}
}What is Queue Durability?
Just like messages, queues themselves can be durable. If a queue is not durable, it will be lost if the RabbitMQ broker restarts. Any messages inside it (even persistent ones!) will also be lost.
Therefore, for true reliability, both the queue and the messages within it must be durable.
Declaring a Durable Queue
To make a queue durable, you simply set the durable parameter to true when declaring it. This must be done by both the producer and consumer when they declare the queue.
Run this example. It declares a durable queue and sends a persistent message.
import com.rabbitmq.client.Channel;
import com.rabbitmq.client.Connection;
import com.rabbitmq.client.ConnectionFactory;
import com.rabbitmq.client.MessageProperties;
public class ProducerDurable {
private final static String DURABLE_QUEUE = "my_durable_queue";
public static void main(String[] argv) throws Exception {
ConnectionFactory factory = new ConnectionFactory();
factory.setHost("localhost");
try (Connection connection = factory.newConnection();
Channel channel = connection.createChannel()) {
// Declare a durable queue (durable = true)
channel.queueDeclare(
DURABLE_QUEUE,
true, // durable
false, // exclusive
false, // autoDelete
null // arguments
);
String message = "Hello from a durable queue!";
channel.basicPublish(
"",
DURABLE_QUEUE,
MessageProperties.PERSISTENT_TEXT_PLAIN, // Persistent message
message.getBytes("UTF-8")
);
System.out.println(" [x] Sent '" + message + "' to durable queue.");
}
}
}Quick Check on Reliability
To ensure maximum message reliability (messages are not lost even if a consumer or broker fails), which combination of features is generally required?
Recap & Next Steps
You've learned how to make your RabbitMQ messaging more reliable!
- Manual Acknowledgements confirm message processing, preventing loss on consumer failure.
- Message Durability (persistent messages) ensures messages survive broker restarts.
- Queue Durability ensures the queue definition itself survives broker restarts.
By combining these, you can build robust systems where messages are rarely lost. Next, you'll explore advanced routing patterns using different types of exchanges!
Frequently asked questions
Is the “Message Acknowledgements & Durability” lesson free?
Yes — the full text of “Message Acknowledgements & Durability” is free to read here on the web, and the RabbitMQ Messaging & Async Systems course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the RabbitMQ Messaging & Async Systems course, upgrade to CoddyKit PRO.
What will I learn in “Message Acknowledgements & Durability”?
Ensure message reliability by implementing manual acknowledgements and making messages and queues durable. Prevent data loss in case of consumer or broker failures. You practise RabbitMQ Messaging & Async Systems with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.
Do I need any experience to start RabbitMQ Messaging & Async Systems?
No prior experience is required. RabbitMQ Messaging & Async Systems on CoddyKit is structured for beginners through advanced learners; this is — lesson 3 of 4, so you can start here or from the beginning and move at your own pace.
How long does the “Message Acknowledgements & Durability” lesson take?
Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.
Can I write and run code in this RabbitMQ Messaging & Async Systems lesson?
Yes. Every RabbitMQ Messaging & Async Systems lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.
All lessons in this course
- Hello World: Simple Queue
- Work Queues: Fair Dispatch
- Message Acknowledgements & Durability
- Publish/Subscribe with Fanout Exchanges