消息队列 / 系统课时

消息与队列过期

消息与队列过期

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 与队列统一消息 TTL 的生效关系

配置并验证两种消息 TTL

下面的 Java 程序声明三个临时测试队列:第一个只设置单条消息 TTL,第二个只设置队列统一 TTL,第三个同时设置两者以验证“取更小值”。示例假设本机 RabbitMQ 可通过 localhost:5672 访问,项目已引入 RabbitMQ Java Client。

java
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"));
        }
    }
}

预期输出

text
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 被删除时,其中消息不会因为这个队列删除动作而进入死信交换机。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

消息与队列过期

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通