如何让rabbitmq消费者优雅的关闭(golang版本)

bin_x · · 2158 次点击 · · 开始浏览    
这是一个创建于 的文章,其中的信息可能已经有所发展或是发生改变。

阅读本文需要掌握的知识:
1、rabbit mq
2、golang

如果项目使用消息队列进行异步处理,大家应该都会碰上一个问题:如果某个消息正在处理中,这时候中断程序(或者更新),那么将会出现数据异常。这种情况可以通过两种方式解决该问题:

1、使用自带的ack机制,将在消息处理完之后,发送ack消息给mq,这样如果处理到一半,程序中断,mq会将该消息发送给其他消费者进行处理。但是该解决方案会产生另一个问题,假如消息处理到一半,一部分数据已经保存到数据库了,那么重新处理可能导致数据异常。这时候需要配合第二种方式进行处理。
2、让程序优雅的中断,也就是graceful shutdown。在接收到中断信号(类似control + c)的时候,不直接退出,而是等所有的子进程处理完闭后再退出。

下面用golang和rabbitmq实现了一个demo,具体代码查看https://github.com/bin-x/rabbitmq-graceful-demo

/lib

该目录放了rabbit mq和server的封装,其中rabbit mq很重要的一点是在消费者代码中将auto-ack设为false,这样就可以在我们处理完消息后手动发送ack消息给rabbitmq的服务器,lib/rabbit.go

    consume, err := ch.Consume(
        queueName,    // queue
        consumerName, // consumer
        false,        // auto-ack, 这里必须设为false
        false,        // exclusive
        false,        // no-local
        true,         // no-wait
        nil,          // args
    )

其他关于rabbitmq需要的配置不在本文讨论范围。这里不展开介绍了。

lib/server.go 中相对重要的方法介绍:

// 开启graceful shutdown。默认不开启
func (srv *server) SetGraceful(duration time.Duration) {
    srv.graceful = true
    srv.gracefulTimeout = duration
}

// server的启动方法,Delivery chan作为参数,可以通过channel不断获取新消息。
func (srv *server) Run(deliveries <-chan amqp.Delivery) {
    go func() {
        // 处理消息
        for d := range deliveries {
            // 开启一个独立协程处理消息,如果不想并行处理多条消息,可以将go关键字去掉
            go srv.startHandler(d)
            // 关闭后不再处理新消息,且通知消息队列重新投递当前接收到的消息
            if srv.close {
                d.Reject(true)
                break
            }
        }
    }()
    // graceful shutdown需要手动开启,否则只是简单的阻塞。
    if srv.graceful {
        srv.gracefulShutdown()
    } else {
        forever := make(chan bool)
        <-forever
    }
}

// 使用*sync.WaitGroup 对handler进行计数,保证所有handler都done之后关闭。
func (srv *server) startHandler(delivery amqp.Delivery) {
    srv.wg.Add(1)
    defer srv.wg.Done()
    srv.handler(delivery)
}

// 核心逻辑
func (srv *server) gracefulShutdown() {
    // 阻塞,直到接收到shutdown的信号
    ch := make(chan os.Signal)
    signal.Notify(ch, syscall.SIGTERM, syscall.SIGQUIT, syscall.SIGINT, syscall.SIGKILL)
    _ = <-ch
    log.Println("receive a shutdown signal")
    //关闭后,Run方法中处理消息的协程将会关闭,不再处理新消息。
    srv.close = true
    
    //最大关闭时间,超过设定时间后,将会强制关闭。
    cxt, cancel := context.WithTimeout(context.Background(), srv.gracefulTimeout)
    defer cancel()

    // graceful关闭
    if err := srv.shutdown(cxt); err != nil {
        log.Fatalln(err)
    }
    log.Println("close the consumer.")
}
// 阻塞,直到触发以下两种情况中的一种:
// 1、所有handler执行完毕,
// 2、到达设置的最大关闭时间,然后抛出一个错误。
func (srv *server) shutdown(ctx context.Context) error {
    go srv.waitGroup()
    select {
    case <-srv.wait:
        return nil
    case <-ctx.Done():
        return ctx.Err()
    }
}
// 监听handler是否完成,如果完成,通知系统可以关闭。
func (srv *server) waitGroup() {
    srv.wg.Wait()
    srv.wait <- true
}

接着我们来看看最重要的consumer.go:

// 创建一个新的server
server := lib.NewServer(work)
// 启用graceful,并设置最大20秒的超时时间,超过该时间强制关闭,防止代码死循环。
server.SetGraceful(time.Second * 20)
// 启动服务
server.Run(consume)
// 消息处理方法
func work(delivery amqp.Delivery) {
    // 模拟长时间执行的任务
    for i := 0; i < 10; i++ {
        log.Println("i:", i)
        time.Sleep(time.Second)
    }
    log.Println("mq's data:", string(delivery.Body[:]))

    // 执行完毕后,需要通知mq。如果没有这条,那这条消息永远不会被确认,在中断rabbtmq的channel或者connection的时候,这条消息将会被重新投递。
    delivery.Ack(false)
}

测试:

consumer.goproducer.go中的rabbitmq信息改为你自己的:
err := mq.Connect("amqp://user:password@ip:port/yourhost")
go get 获取对应的包。
首先启动消费者:

$ go run consumer.go
2020/09/26 22:04:02 start consumer...

接着在一个新的终端页面,通过生产者发送条消息到队列中:

$ go run producer.go
2020/09/26 22:22:54 send message: this is message

这时候赶紧切回消费者的终端,按control+c,输出如下:

2020/09/26 22:04:02 start consumer...
2020/09/26 22:22:54 i: 0
2020/09/26 22:22:55 i: 1
2020/09/26 22:22:56 i: 2
2020/09/26 22:22:57 i: 3
^C2020/09/26 22:22:57 receive a shutdown signal
2020/09/26 22:22:58 i: 4
2020/09/26 22:22:59 i: 5
2020/09/26 22:23:00 i: 6
2020/09/26 22:23:01 i: 7
2020/09/26 22:23:02 i: 8
2020/09/26 22:23:03 i: 9
2020/09/26 22:23:04 mq's data: this is message
2020/09/26 22:23:04 close the consumer.

上面的演示中,我在第三秒的时候,按下了control + c, 然后程序接着执行,到整个任务执行完毕后,整个程序才真正关闭。

注意点:在control + c到真正关闭这段时间,你也可以通过生产者程序再发一条消息到队列中,看看新的消息是否会被处理(如果会被处理,在消息量大的情况下可能会触发强制关闭,导致最后几条消息执行异常。),这里不做演示了,读者可自行测试。


有疑问加站长微信联系(非本文作者)

本文来自:简书

感谢作者:bin_x

查看原文:如何让rabbitmq消费者优雅的关闭(golang版本)

入群交流(和以上内容无关):加入Go大咖交流群,或添加微信:liuxiaoyan-s 备注:入群;或加QQ群:692541889

2158 次点击  
加入收藏 微博
暂无回复
添加一条新回复 (您需要 登录 后才能回复 没有账号 ?)
  • 请尽量让自己的回复能够对别人有帮助
  • 支持 Markdown 格式, **粗体**、~~删除线~~、`单行代码`
  • 支持 @ 本站用户;支持表情(输入 : 提示),见 Emoji cheat sheet
  • 图片支持拖拽、截图粘贴等方式上传