消息队列 / 系统课时
消息与队列过期
消息与队列过期
TTL 用来限制消息在队列中可停留多久,但 RabbitMQ 同时支持“发布时给单条消息设 TTL”和“给队列中的所有消息设统一 TTL”。本篇通过可运行示例验证两种配置,并说明它们叠加时的实际生效规则。
学习目标
- 配置单条消息的
expiration和队列级x-message-ttl - 验证消息过期后不会再被消费者或
basic.get取到 - 区分消息 TTL、队列统一消息 TTL 与真正的队列过期
x-expires
两种 TTL 控制的是消息驻留时间
单条消息 TTL 由生产者在发布属性 expiration 中设置,适合不同消息有不同有效期;队列统一消息 TTL 使用 x-message-ttl 或策略配置,适合一个队列中的消息遵守同一上限。两者的时间单位都是毫秒,而 AMQP 0-9-1 的 expiration 值以数字字符串传递。
同一条消息如果同时带有单条 TTL,又进入配置了统一消息 TTL 的队列,实际有效期取两者较小值。消息被路由到多个队列时,各队列独立计算其驻留时间,因此同一消息可能在一个队列先过期、在另一个队列仍有效。

配置并验证两种消息 TTL
下面的 Java 程序声明三个临时测试队列:第一个只设置单条消息 TTL,第二个只设置队列统一 TTL,第三个同时设置两者以验证“取更小值”。示例假设本机 RabbitMQ 可通过 localhost:5672 访问,项目已引入 RabbitMQ Java Client。
import com.rabbitmq.client.AMQP;
import com.rabbitmq.client.Channel;
import com.rabbitmq.client.Connection;
import com.rabbitmq.client.ConnectionFactory;
import java.nio.charset.StandardCharsets;
import java.util.Map;
public class TtlDemo {
public static void main(String[] args) throws Exception {
ConnectionFactory factory = new ConnectionFactory();
factory.setHost("localhost");
try (Connection connection = factory.newConnection();
Channel channel = connection.createChannel()) {
String perMessageQueue =
channel.queueDeclare("", false, true, true, null).getQueue();
String perQueueQueue =
channel.queueDeclare("", false, true, true,
Map.of("x-message-ttl", 2000)).getQueue();
String minRuleQueue =
channel.queueDeclare("", false, true, true,
Map.of("x-message-ttl", 10000)).getQueue();
AMQP.BasicProperties ttl2s = new AMQP.BasicProperties.Builder()
.expiration("2000")
.build();
AMQP.BasicProperties noTtl = new AMQP.BasicProperties.Builder().build();
byte[] body = "demo".getBytes(StandardCharsets.UTF_8);
// 单条 TTL、队列统一 TTL,以及两者叠加的最小值规则。
channel.basicPublish("", perMessageQueue, ttl2s, body);
channel.basicPublish("", perQueueQueue, noTtl, body);
channel.basicPublish("", minRuleQueue, ttl2s, body);
Thread.sleep(2500);
System.out.println("per-message: " +
(channel.basicGet(perMessageQueue, true) == null ? "expired" : "alive"));
System.out.println("per-queue: " +
(channel.basicGet(perQueueQueue, true) == null ? "expired" : "alive"));
System.out.println("min-rule: " +
(channel.basicGet(minRuleQueue, true) == null ? "expired" : "alive"));
}
}
}预期输出
per-message: expired
per-queue: expired
min-rule: expired这里验证的是“过期消息不会再被取到”,不是要求 Broker 必须在 TTL 到点的同一毫秒立即回收其占用空间。实际调度存在时序差异,所以测试应判断能否继续投递,而不要依赖精确到毫秒的删除时间。
选择发布属性还是队列策略
如果有效期是消息自身的业务属性,例如验证码 30 秒、订单超时事件 15 分钟,应使用单条 expiration。如果队列承担统一时效要求,例如所有实时通知最多保留 10 分钟,更适合使用队列级 x-message-ttl;需要线上调整时,优先考虑策略而不是把值硬编码进应用的队列声明。
过期消息如果没有配置死信交换机,会被丢弃;配置了 DLX 时,可以进入死信链路继续处理。设计重试队列时,TTL 常与 DLX 组合使用,但 TTL 只负责“何时失效”,不能代替重试次数、幂等消费和最终失败处置。
理解队列本身的过期
x-expires 描述的是队列在持续未使用达到指定时长后被删除,单位同样是毫秒,而且必须是正整数。它解决临时队列、RPC 回复队列等资源回收问题,不决定单条消息能存多久。
因此看到“TTL”时先问清对象:expiration 是单条消息的时钟,x-message-ttl 是某个队列内所有消息的统一驻留上限,x-expires 才是队列自身的闲置生命周期。队列因 x-expires 被删除时,其中消息不会因为这个队列删除动作而进入死信交换机。