一、概述
死信有死信队列、死信交换器和死信消息组成。死信消息则有如下三种情况生成:
1.消费者使用basic.reject或 basic.nack并将requeue参数设置为false来拒绝该消息
2.消息设置了TTL过期时间,过期时间内没有消费导致过期
3.消息因超过队列长度导致被丢弃
如果队列删除或者队列的TTL过期时间到了被删除其中的消息是不会成为死信消息的。
每个队列可通过队列参数arg或者策略policy设置死信交换器和死信路由键来处理死信消息,当队列参数与策略都有设置时,以队列参数设置内容为准,建议使用策略。没有设置死信,消息满足死信条件将会被丢弃。
简而言之,一个队列A设置了死信交换器和路由键,当一个消息满足死信要求时会通过设置的死信交换器和路由键找到对应的队列将消息传递到对应队列B中,B也就是对应的死信队列。所以,死信交换机和死信队列都是正常的交换器和队列,和其他的交换器队列声明没区别。通过死信队列可以防止消息的意外丢失,保证重要的消息被执行记录。
二、在策略中设置死信
我们通过rabbitmqctl命令创建一个名为DLX的设置了死信交换器为my-dlx路由键为my-dlx-routekey的策略,对应用于所有的队列。
rabbitmqctl set_policy --vhost my_vhost1 DLX ".*" '{"dead-letter-exchange":"my-dlx","dead-letter-routing-key":"my-dlx-routekey"}' --apply-to queues
或者在web管理页中添加policy如下:
有多个策略的话使用优先级最高的策略,设置后队列会有个DLX的特性。
三、在队列参数中设置死信
我们通过队列参数设置x-dead-letter-exchange和x-dead-letter-routing-key,死信交换器必须和队列处于同一个vhost下,示例代码如下:
Dictionary<string, object> arg = new Dictionary<string, object>(); arg.Add("x-dead-letter-exchange","hello-dlx"); arg.Add("x-dead-letter-routing-key", "hello-dlx-routekey"); channel.QueueDeclare( "HelloQueue",//队列名称 false, //是否持久化 false, //是否只对首次声明的队列可见 false, //是否自动删除 arg ////关于队列和队列内消息的详细设置,键值对形式 );
四、死信路由
我们在上述代码中都设置了死信路由键,但是其实是可以不设置的,如果设置了就遵循设置的路由键,如果没有设置则遵循原交换器的路由键。比如:我们将消息发送到路由键为A的交换器进入队列,则当消息死信时也发送到路由键为A的死信交换器,如果设置了x-dead-letter-routing-key为B则发送到路由键为B的死信交换器中。如果不设置死信路由键,那么由CC和BCC设置的路由键也会触发,CC和BCC相当于抄送和密送到别的交换器。
如果产生死信循环,既到达同一个队列两次,消息将会被抛弃。当死信消息发送到死信队列后将会从原队列删除,避免过多消息的积压,但是如果目标的死信队列不能接受消息,则该死信消息将可能丢失。
五、死信消息
当死信消息被发送到死信队列后会有以下变化:
1.消息的交换器名称会改为死信交换器名称;
2.设置了死信路由键的话,路由键会相应更改;
3.CC和BCC标头将会删除;
死信消息将会添加一些标头,我们先看下打印的标头:
{"Headers":{ "x-death":[ { "count":1, "reason":"ZXhwaXJlZA==", "queue":"SGVsbG9RdWV1ZQ==", "time":{ "UnixTime":1637409202 }, "exchange":"SGVsbG9FeGNoYW5nZQ==", "routing-keys":[ "aG9sYQ==" ] } ], "x-first-death-exchange":"SGVsbG9FeGNoYW5nZQ==", "x-first-death-queue":"SGVsbG9RdWV1ZQ==", "x-first-death-reason":"ZXhwaXJlZA==" } }
可以看到值是Base64格式的,新添加了x-death、x-first-death-exchange、x-first-death-queue、x-first-death-reason四个值。
x-first-death-exchange:第一次的成为死信时的交换器名称;
x-first-death-queue:第一次的成为死信时的队列名称;
x-first-death-reason:第一次的成为死信时的原因,死亡原因分为四种下同分别是:rejected(消息处理被拒绝)、expired (ttl时间到期)、maxlen(超过队列允许最大长度)和Delivery-limit(消息返回的次数超限额)
这三个是第一次死信的时候添加的,后面就不会变了。
x-death里面是数组形式的,因为消息可能多次死信。新条目被添加到x-death 数组的开头。如果x-death已经包含一个具有相同队列和死字原因的条目,它的计数字段count将增加,并将移到数组的开头。
queue:消息在死信之前所在队列的名称;
reason:死信的原因,同上;
time:消息被死信的日期和时间,为 64 位 AMQP 0-9-1 时间戳;
exchange :消息发布到的交换器名(请注意,如果消息多次死信,这将是死信交换);
routing-keys :消息发布时使用的路由键(包括CC密钥,但不包括BCC密钥 );
count : 由于这个原因,这条消息在这个队列中被死信多少次;
original-expiration(如果消息由于消息的TTL死信的):消息的原始到期属性。该到期属性从死刻字的消息,以防止它被路由到任何队列再次到期删除。
学习链接:https://www.rabbitmq.com/dlx.html