go-zero 框架通过内置的 mq 模块提供消息队列消费者支持,核心做法是定义实现 consumer 接口的结构体并注册到 mq.newmqconsumer。你需要创建一个包含 consume(ctx context.context, msg *mqueue.message) error 方法的类型,并在 main 函数中配置连接参数、订阅主题以及处理逻辑,启动后框架会自动拉取消息并执行你的业务代码。

如何定义消息处理逻辑与接口
在 Go-Zero 中,消费者必须实现 mqueue.Consumer 接口,该接口仅包含一个方法 Consume。这个方法接收上下文和消息对象,返回错误。如果处理成功,返回 nil;如果处理失败且希望重试或进入死信队列,则返回具体的错误信息。这是接入 MQ 的基础契约,所有业务逻辑都封装在这个方法内。

package main
import (
"context"
"fmt"
"github.com/zeromicro/go-zero/core/mq"
)
// MyConsumer 实现 mqueue.Consumer 接口
type MyConsumer struct {
name string
}
// Consume 处理单条消息
func (c *MyConsumer) Consume(ctx context.Context, msg *mqueue.Message) error {
// 1. 解析消息内容
body := string(msg.Body)
fmt.Printf("Received message from topic %s: %s\n", msg.Topic, body)
// 2. 执行业务逻辑
// 例如:写入数据库、调用服务等
if err := c.processBusiness(body); err != nil {
return fmt.Errorf("process failed: %w", err)
}
// 3. 返回 nil 表示消费成功,MQ 会确认该消息
return nil
}
func (c *MyConsumer) processBusiness(body string) error {
// 模拟业务处理
if len(body) == 0 {
return fmt.Errorf("empty body")
}
return nil
}
func main() {
consumer := &MyConsumer{name: "test-consumer"}
// 创建消费者实例
mqConsumer := mq.NewMqConsumer(
"my-topic",
mq.WithKafkaBrokers([]string{"localhost:9092"}),
mq.WithGroupID("my-group"),
mq.WithConsumer(consumer),
)
// 启动消费者
if err := mqConsumer.Consume(); err != nil {
panic(err)
}
select {} // 阻塞主进程
}
如何配置连接参数与启动流程
配置 MQ 消费者主要涉及连接地址、消费者组 ID 以及具体的消费者实例。Go-Zero 的 mq 包目前主要支持 Kafka,通过 mq.NewMqConsumer 函数进行初始化。你需要传入主题名称,并使用选项模式设置 Broker 地址列表、消费者组(Group ID)以及之前定义的 Consumer 实现。调用 Consume() 方法后,程序会进入阻塞状态,持续监听并处理消息。

// 配置示例:使用 Kafka 作为后端
mqConsumer := mq.NewMqConsumer(
"order-topic", // 主题名称
mq.WithKafkaBrokers([]string{"127.0.0.1:9092"}), // Broker 地址
mq.WithGroupID("order-service-group"), // 消费者组 ID
mq.WithConsumer(&OrderHandler{}), // 业务处理器
mq.WithMaxRetry(3), // 最大重试次数(可选)
)
// 启动
err := mqConsumer.Consume()
if err != nil {
log.Fatalf("Failed to start consumer: %v", err)
}
当 Consume 方法返回非 nil 错误时会发生什么
当 Consume 方法返回非 nil 的错误时,Go-Zero 的 MQ 消费者会根据配置的重试策略进行处理。默认情况下,如果底层客户端(如 Kafka)支持重试机制,框架可能会尝试重新投递该消息。如果重试次数耗尽或配置了死信队列,消息可能会被转移到死信主题或根据具体 MQ 的实现进行丢弃。开发者应确保在处理逻辑中捕获可恢复的错误,以便触发重试,而对于不可恢复的业务错误,则记录日志并返回错误以触发相应的告警或人工介入流程。











