读本文之前,你应该已经了解 RabbitMQ 的一些概念,如队列、交换机之类。
死信概念
通俗来讲,无法被正常消费的消息,我们可以称之为死信。我们将其放入死信队列,单独处理这部分“异常”消息。
当消息符合以下的一个条件时,将会称为死信。
- 消息被拒绝,不重新放回队列(使用 basic.reject / basic.nack 方法拒绝消息,并且这两个方法的参数 requeue = false)
- 消息TTL过期
- 队列达到最大长度
应用
应用场景:当消费者无法正常消费消息、消息发生异常时,为了保证数据不丢失,将异常的消息置为死信,放入死信队列。在死信队列中的消息,将启动单独的消费程序特殊处理。
架构图:
下面跟着架构图来实现代码。
生产者
一个生产者一般来说只需要做两件事,一是创建链接,二是发送消息。
RabbitMQ 中涉及的队列、交换机、routing-key,这些都需要在代码中实现创建。这些操作既可以由生产者创建,也可以由消费者创建。关于谁来创建的探讨,见RabbitMq:谁来创建队列和交换机?此文。
本文中队列、交换机、routing-key 放到生产者一方来实现。所以生产者一共需要做这几件事。
- 创建连接
- 设置队列(队列、交换机、绑定)
- 设置死信队列(队列、交换机、绑定)
- 发布消息
创建连接
利用streadway/amqp包,与RabbitMQ 建立连接。
func main() {
mq := util.NewRabbitMQ()
defer mq.Close()
mqCh := mq.Channel
……
}
……
// util.NewRabbitMQ()
func NewRabbitMQ() *RabbitMQ {
conn, err := amqp.Dial(constant.MqUrl)
FailOnError(err, "Failed to connect to RabbitMQ")
ch, err := conn.Channel()
FailOnError(err, "Failed to open a channel")
return &RabbitMQ{
Conn: conn,
Channel: ch,
}
}
设置队列(队列、交换机、绑定)
核心操作就是设置队列阶段。
声明普通队列,并指定死信交换机、指定死信routing-key。后续死信队列创建后会与死信交换机、指定死信routing-key进行绑定。
var err error
_, err = mqCh.QueueDeclare(constant.NormalQueue, true, false, false, false, amqp.Table{
"x-message-ttl": 5000, // 消息过期时间,毫秒
"x-dead-letter-exchange": constant.DeadExchange, // 指定死信交换机
"x-dead-letter-routing-key": constant.DeadRoutingKey, // 指定死信routing-key
})
util.FailOnError(err, "创建normal队列失败")
声明交换机
err = mqCh.ExchangeDeclare(constant.NormalExchange, amqp.ExchangeDirect, true, false, false, false, nil)
util.FailOnError(err, "创建normal交换机失败")
目前,普通队列和交换机都已经创建,但它们都是独立存在,没有关联。
通过 QueueBind 将队列、routing-key、交换机三者绑定到一起。
err = mqCh.QueueBind(constant.NormalQueue, constant.NormalRoutingKey, constant.NormalExchange, false, nil)
util.FailOnError(err, "normal:队列、交换机、routing-key 绑定失败")
设置死信队列(队列、交换机、绑定)
同样死信队列,也需要创建队列、创建交换机和绑定。
// 声明死信队列
// args 为 nil。切记不要给死信队列设置消息过期时间,否则失效的消息进入死信队列后会再次过期。
_, err = mqCh.QueueDeclare(constant.DeadQueue, true, false, false, false, nil)
util.FailOnError(err, "创建dead队列失败")
// 声明交换机
err = mqCh.ExchangeDeclare(constant.DeadExchange, amqp.ExchangeDirect, true, false, false, false, nil)
util.FailOnError(err, "创建dead队列失败")
// 队列绑定(将队列、routing-key、交换机三者绑定到一起)
err = mqCh.QueueBind(constant.DeadQueue, constant.DeadRoutingKey, constant.DeadExchange, false, nil)
util.FailOnError(err, "dead:队列、交换机、routing-key 绑定失败")
当死信队列建立完毕,普通队列通过 x-dead-letter-exchange
和 x-dead-letter-routing-key
参数的指定,便可生效,死信队列便与普通队列连通。
发布消息
message := "msg" + strconv.Itoa(int(time.Now().Unix()))
fmt.Println(message)
// 发布消息
err = mqCh.Publish(constant.NormalExchange, constant.NormalRoutingKey, false, false, amqp.Publishing{
ContentType: "text/plain",
Body: []byte(message),
})
util.FailOnError(err, "消息发布失败")
生产者完整代码
package main
import (
"fmt"
"github.com/streadway/amqp"
"learn_gin/go/rabbitmq/deadletter/constant"
"learn_gin/go/rabbitmq/deadletter/util"
"strconv"
"time"
)
func main() {
// # ========== 1.创建连接 ==========
mq := util.NewRabbitMQ()
defer mq.Close()
mqCh := mq.Channel
// # ========== 2.设置队列(队列、交换机、绑定) ==========
// 声明队列
var err error
_, err = mqCh.QueueDeclare(constant.NormalQueue, true, false, false, false, amqp.Table{
"x-message-ttl": 5000, // 消息过期时间,毫秒
"x-dead-letter-exchange": constant.DeadExchange, // 指定死信交换机
"x-dead-letter-routing-key": constant.DeadRoutingKey, // 指定死信routing-key
})
util.FailOnError(err, "创建normal队列失败")
// 声明交换机
err = mqCh.ExchangeDeclare(constant.NormalExchange, amqp.ExchangeDirect, true, false, false, false, nil)
util.FailOnError(err, "创建normal交换机失败")
// 队列绑定(将队列、routing-key、交换机三者绑定到一起)
err = mqCh.QueueBind(constant.NormalQueue, constant.NormalRoutingKey, constant.NormalExchange, false, nil)
util.FailOnError(err, "normal:队列、交换机、routing-key 绑定失败")
// # ========== 3.设置死信队列(队列、交换机、绑定) ==========
// 声明死信队列
// args 为 nil。切记不要给死信队列设置消息过期时间,否则失效的消息进入死信队列后会再次过期。
_, err = mqCh.QueueDeclare(constant.DeadQueue, true, false, false, false, nil)
util.FailOnError(err, "创建dead队列失败")
// 声明交换机
err = mqCh.ExchangeDeclare(constant.DeadExchange, amqp.ExchangeDirect, true, false, false, false, nil)
util.FailOnError(err, "创建dead队列失败")
// 队列绑定(将队列、routing-key、交换机三者绑定到一起)
err = mqCh.QueueBind(constant.DeadQueue, constant.DeadRoutingKey, constant.DeadExchange, false, nil)
util.FailOnError(err, "dead:队列、交换机、routing-key 绑定失败")
// # ========== 4.发布消息 ==========
message := "msg" + strconv.Itoa(int(time.Now().Unix()))
fmt.Println(message)
// 发布消息
err = mqCh.Publish(constant.NormalExchange, constant.NormalRoutingKey, false, false, amqp.Publishing{
ContentType: "text/plain",
Body: []byte(message),
})
util.FailOnError(err, "消息发布失败")
}
消费者
由于队列、交换机都交由生产者来创建,消费者只需做两件,一是建立连接、二是消费消息。
也由于这个原因,消费者要晚于生产者启动,可以保证消费的时候,队列是存在的。
package main
import (
"learn_gin/go/rabbitmq/deadletter/constant"
"learn_gin/go/rabbitmq/deadletter/util"
"log"
)
func main() {
// # ========== 1.创建连接 ==========
mq := util.NewRabbitMQ()
defer mq.Close()
mqCh := mq.Channel
// # ========== 2.消费消息 ==========
msgsCh, err := mqCh.Consume(constant.NormalQueue, "", false, false, false, false, nil)
util.FailOnError(err, "消费normal队列失败")
forever := make(chan bool)
go func() {
for d := range msgsCh {
// 要实现的逻辑
log.Printf("接收的消息: %s", d.Body)
// 手动应答
d.Ack(false)
//d.Reject(true)
}
}()
log.Printf("[*] Waiting for message, To exit press CTRL+C")
<-forever
}
死信消费者
死信队列、交换机都也交由生产者来创建了,死信消费者也只需做两件,建立连接和消费消息。
package main
import (
"learn_gin/go/rabbitmq/deadletter/constant"
"learn_gin/go/rabbitmq/deadletter/util"
"log"
)
func main() {
// # ========== 1.创建连接 ==========
mq := util.NewRabbitMQ()
defer mq.Close()
mqCh := mq.Channel
// # ========== 2.消费死信消息 ==========
msgsCh, err := mqCh.Consume(constant.DeadQueue, "", false, false, false, false, nil)
util.FailOnError(err, "消费dead队列失败")
forever := make(chan bool)
go func() {
for d := range msgsCh {
// 要实现的逻辑
log.Printf("接收的消息: %s", d.Body)
// 手动应答
d.Ack(false)
//d.Reject(true)
}
}()
log.Printf("[*] Waiting for message, To exit press CTRL+C")
<-forever
}
end!
个人博客同步文章 Golang 实现 RabbitMQ 的死信队列
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。