【rabbitmq 高级特性】全面详解RabbitMQ TTL (Time To Live)

public class Constant {
    // TTL
    public static final String TTL_QUEUE = "ttl_queue"; // 用于测试消息TTL
    public static final String TTL_QUEUE2 = "ttl_queue2"; // 用于测试队列TTL
    public static final String TTL_EXCHANGE_NAME = "ttl_exchange";
}

@Configuration
public class TtlConfig {
    // 1. 交换机
    @Bean("ttlExchange")
    public FanoutExchange ttlExchange() {
        return ExchangeBuilder.fanoutExchange(Constant.TTL_EXCHANGE_NAME).durable(true).build();
    }

    // 2.1 普通队列（用于后续测试消息TTL）
    @Bean("ttlQueue")
    public Queue ttlQueue() {
        return QueueBuilder.durable(Constant.TTL_QUEUE).build();
    }

    // 2.2 设置队列TTL的队列（20秒）
    @Bean("ttlQueue2")
    public Queue ttlQueue2() {
        return QueueBuilder.durable(Constant.TTL_QUEUE2)
                .withArgument("x-message-ttl", 20000) // 关键参数：设置队列TTL为20秒
                .build();
    }
    // 使用.ttl()方法简写（Spring AMQP封装）
    // public Queue ttlQueue2() {
    //     return QueueBuilder.durable(Constant.TTL_QUEUE2)
    //             .ttl(20000)
    //             .build();
    // }

    // 3. 绑定关系
    @Bean("ttlBinding")
    public Binding ttlBinding(@Qualifier("ttlExchange") FanoutExchange exchange,
                              @Qualifier("ttlQueue") Queue queue) {
        return BindingBuilder.bind(queue).to(exchange);
    }

    @Bean("ttlBinding2")
    public Binding ttlBinding2(@Qualifier("ttlExchange") FanoutExchange exchange,
                               @Qualifier("ttlQueue2") Queue queue) {
        return BindingBuilder.bind(queue).to(exchange);
    }
}

2. 生产者：发送带TTL的消息

复制代码

@RestController
@RequestMapping("/producer")
public class ProducerController {
    @Autowired
    private RabbitTemplate rabbitTemplate;

    // 测试1：发送带消息TTL的消息 (10秒)
    @RequestMapping("/ttlmsg")
    public String sendMessageWithTtl() {
        String ttlTime = "10000"; // 10秒

        rabbitTemplate.convertAndSend(Constant.TTL_EXCHANGE_NAME, "", 
            "This is a message with 10s TTL", 
            message -> {
                // 关键：为单条消息设置TTL属性
                message.getMessageProperties().setExpiration(ttlTime);
                return message;
            });
        return "发送成功! 消息将在10秒后过期。";
    }

    // 测试2：发送到带队列TTL的队列 (队列TTL为20秒)
    @RequestMapping("/ttlqueue")
    public String sendMessageToTtlQueue() {
        // 这条消息会继承队列的TTL设置，20秒后过期
        rabbitTemplate.convertAndSend(Constant.TTL_EXCHANGE_NAME, "", 
            "This is a message in a 20s TTL queue");
        return "发送成功! 消息将在20秒后过期。";
    }
}

3. 观察结果

运行程序，调用两个接口后，在RabbitMQ管理界面可以看到：

ttl_queue2的 Features 会显示 TTL 标志，表示这是一个设置了TTL的队列。
发送消息后，队列中的 Ready 消息数为1。
等待相应的秒数（10秒或20秒）后刷新页面，会发现消息自动消失了（如果队列未配置死信交换机）。

四、两种TTL的内部原理与区别

特性	消息TTL (Per-Message)	队列TTL (Queue)
设置位置	消息属性 (`expiration`)	队列参数 (`x-message-ttl`)
灵活性	高，每条消息可以不同	低，队列内所有消息相同
生效时机	惰性检查：消息并非在到期时立刻被删除，而是只有在即将被投递给消费者时才会检查是否过期。	主动检查：RabbitMQ会定期从队列头部开始扫描并删除已过期的消息。
性能影响	不影响。因为过期消息只在被投递时才会被清理。	有较小影响。Broker需要后台任务定期扫描队列。
适用场景	需要为不同消息设置不同过期时间的场景。	队列中所有消息具有相同过期时间的场景，配置更简单。

为什么会有不同的生效机制？

队列TTL：队列中的消息过期时间相同，过期的消息肯定集中在队列头部，只需定期扫描头部即可，效率高。
消息TTL：每条消息的过期时间都不同，如果要立即删除过期消息，需要遍历整个队列，性能开销巨大。因此采用惰性检查，在消费时再判断，是性能与功能的最佳权衡。

五、应用：结合死信队列

单纯让消息过期后消失通常没有业务意义。TTL的真正威力在于与死信队列（DLX）结合使用，实现延迟队列和定时任务。

工作流程（对应上方流程图）：

创建一个普通队列 normal_queue，并为其设置：
- x-message-ttl=10000(TTL=10秒)
- x-dead-letter-exchange=dlx_exchange(绑定死信交换机)
消费者不监听 normal_queue，而是监听绑定的死信队列 dlx_queue。
生产者将消息发送到 normal_queue。
消息在 normal_queue中存活10秒后过期。
由于配置了DLX，过期的消息不会消失，而是被自动转发到 dlx_exchange，并路由到 dlx_queue。
消费者从 dlx_queue中消费到消息。此时，从消息发送到被消费，正好延迟了10秒。

这样就实现了一个延迟队列，可用于处理订单超时关单等场景。

总结

TTL是RabbitMQ中一个非常实用的高级特性，它通过两种方式为消息赋予了"生命周期"：

消息TTL：提供了灵活性，允许细粒度控制每条消息的过期时间。
队列TTL：提供了便利性，为一批消息提供统一的过期配置。

核心要点：

理解两者不同的生效机制（惰性检查 vs. 主动扫描）及其背后的原因。
TTL通常不会单独使用，其最佳实践是与死信队列（DLX）结合来构建延迟队列，解决如订单超时、定时任务等经典业务问题。
在选择使用哪种TTL时，根据业务的灵活性和简便性要求做出权衡。