Hyperf中延迟队列应使用TTL+死信队列方案而非x-delayed-message插件，需配置带x-message-ttl和x-dead-letter-exchange参数的延迟队列，并确保死信交换机正确绑定消费队列。
延迟队列在Hyperf里不能直接用x-delayed-message
Hyperf 默认的 hyperf/amqp 不支持 RabbitMQ 的 x-delayed-message 插件（即延迟交换机），因为该插件需要显式声明自定义交换机类型，而组件默认只允许使用 direct、topic、fanout 这三种标准类型。如果你直接配置 type => 'x-delayed-message'，会报错：AMQPChannelException: PRECONDITION_FAILED - invalid exchange type。
- 必须手动注册延迟交换机，并在发布消息时指定该交换机名称，而非依赖 AMQP 协议原生延迟参数
- 不能把延迟逻辑写在消费者里 sleep，那会阻塞协程、浪费连接、无法精准控制
- 推荐方案是：用普通 topic 交换机 + TTL + 死信路由，这是 RabbitMQ 官方推荐且
hyperf/amqp原生兼容的方式
配置死信队列实现延迟效果（hyperf/amqp v3.x）
核心思路是：发消息到一个带 TTL 的队列 → 消息过期后自动进入死信交换机 → 路由到真实消费队列。所有配置都在 config/autoload/amqp.php 中完成。
- 先定义一个「延迟队列」：设置
arguments包含x-message-ttl（毫秒）和x-dead-letter-exchange（指向你的业务交换机） - 再定义一个「死信交换机」，类型为
topic，绑定到最终消费队列，routing key 需与死信配置中x-dead-letter-routing-key一致 - 消费者只需监听最终消费队列，不感知延迟逻辑
'delay_queue' => [
'host' => 'localhost',
'port' => 5672,
'user' => 'guest',
'password' => 'guest',
'vhost' => '/',
'queue' => 'delayed.order.process',
'exchange' => 'delay.exchange',
'exchange_type' => 'topic',
'routing_key' => 'delay.order',
'arguments' => [
'x-message-ttl' => 5000, // 5秒后过期
'x-dead-letter-exchange' => 'order.exchange',
'x-dead-letter-routing-key' => 'order.process',
],
],
'order_queue' => [
'host' => 'localhost',
'port' => 5672,
'user' => 'guest',
'password' => 'guest',
'vhost' => '/',
'queue' => 'order.process',
'exchange' => 'order.exchange',
'exchange_type' => 'topic',
'routing_key' => 'order.process',
],发送延迟消息时别漏掉 exchange 和 routing_key
调用 $this->producer->push() 时，必须显式传入目标延迟交换机名和 routing key，否则消息会进默认交换机，TTL 不生效。
- 不能只写
$this->producer->push($data, 'delay_queue')—— 这会走配置里的exchange和routing_key，但你得确认它们确实指向延迟队列配置项 - 更稳妥的是直接指定：
$this->producer->push($data, 'delay_queue', ['exchange' => 'delay.exchange', 'routing_key' => 'delay.order']) - 如果延迟时间需动态变化（比如不同订单延迟 10s / 30s / 60s），就得为每种延迟时长预设独立的延迟队列配置，不能运行时改 TTL
消费者端无需特殊处理，但要注意死信链路是否通畅
延迟消息最终落到 order.process 队列，消费者按常规方式监听即可。真正容易出问题的是中间环节：
- RabbitMQ 是否已启用
dead-letter-exchange支持？默认开启，但若集群有策略限制，可能被禁用 - 检查
delayed.order.process队列的Arguments是否包含正确的x-dead-letter-exchange和x-dead-letter-routing-key（用rabbitmqctl list_queues name arguments查） - 确保
order.exchange已绑定order.process队列，且 binding key 与死信 routing key 完全一致（包括大小写）
延迟不准、消息消失、卡在延迟队列不转发——八成是死信路由没对上，而不是代码写错了。
