消息队列 / 系统课时
消息 TTL 怎样控制存活时间
消息 TTL 怎样控制存活时间
TTL 用来限制消息在队列里最多保留多久,最常见的目标是清理过期任务、实现延迟重试窗口,或防止长期积压。RabbitMQ 同时支持队列级消息 TTL 和单条消息 TTL;理解两者叠加后的实际过期时间,才能避免消息提前失效或长期占用资源。
学习目标
- 区分队列级消息 TTL、单条消息 TTL 与队列自身 TTL
- 能为指定队列配置统一的消息存活时间
- 理解消息过期后进入 DLX 或被丢弃的条件
TTL 控制的是队列中的保留时间
队列级消息 TTL 会对进入该队列的消息统一设置最大保留时长,策略键是 message-ttl,单位为毫秒。单条消息 TTL 则由发布者在消息属性 expiration 中指定,同样使用毫秒,但值以字符串形式传递。
如果同一条消息同时受到两种 TTL 约束,实际有效期限取更早到期的一方。例如队列限制 30 秒,而某条消息的 expiration 是 5 秒,那么这条消息最多只在该队列保留约 5 秒。

给队列统一设置消息 TTL
假设 business.q 已存在,希望其中消息最多保留 30 秒,可以用 Policy 动态应用 TTL。正则只匹配这一条队列,避免误伤其他业务队列。
rabbitmqctl set_policy business-message-ttl '^business\.q$' '{"message-ttl":30000}' --apply-to queues预期结果
business.q 命中 business-message-ttl 策略,新策略把该队列中的消息最大保留时间限制为 30000 毫秒。策略适合集中运维,因为调整 TTL 时不需要把数值硬编码进应用的队列声明。若现有消息已经在队列中,过期消息何时真正从存储结构中清理与队列类型和消息所在位置有关,但过期消息不会再按正常消息交付给消费者。
给单条消息设置 TTL
单条消息 TTL 适合“同一队列中不同任务有不同截止时间”的场景。下面是 AMQP 0-9-1 消息属性的片段示例,依赖发布端已经创建消息属性并准备调用 basic.publish;expiration 必须是表示毫秒数的字符串。
{
"expiration": "5000"
}这表示该消息在队列中的存活上限为 5000 毫秒。若队列还配置了更短的 message-ttl,则以更短的期限为准。
过期之后消息去了哪里
消息过期后不会再被正常消费者拿到。如果源队列配置了 DLX,过期消息会走死信路由;没有 DLX 时,过期消息会被丢弃。因此“设置 TTL”只解决何时失效,“失效后去哪”还要由 DLX 和 Binding 决定。
设计 TTL 时应从业务截止时间反推,而不是随便给一个较小数值。需要失败留痕或后续补偿时,把 TTL 与 DLX 配合;只需要自动淘汰无价值消息时,单独使用 TTL 即可。