go-zero 框架通过内置的 mq 模块结合事务消息机制,在微服务间保障最终一致性。具体做法是:生产者发送消息时携带业务数据,由 mq 返回消息 id;随后执行本地数据库事务,将业务数据与消息 id 绑定存储;若本地事务成功,则向 mq 确认发送该消息;若失败,则丢弃或标记为异常。消费者监听 mq 消息,收到后执行业务逻辑并更新状态。这种模式确保了本地事务与消息发送的原子性,即使系统出现短暂故障,也能通过重试机制保证数据最终一致。

如何配置 Go-Zero 的事务消息生产者
要使用事务消息,需要在 go-zero 的配置文件中定义 Mq 节点,指定 Broker 地址和 Topic。代码中需引入 github.com/zeromicro/go-zero/core/mq 包,并使用 NewMqProducer 创建生产者实例。调用 SendMessageInTransaction 方法时,传入一个回调函数,该函数包含本地事务的执行逻辑。如果本地事务提交,则返回 mq.CommitMessage;如果回滚,则返回 mq.RollbackMessage。这样,MQ 服务器会根据回调结果决定消息是否投递给消费者。

package main
import (
"context"
"fmt"
"log"
"github.com/zeromicro/go-zero/core/mq"
)
type OrderService struct {
producer mq.Producer
}
func (o *OrderService) CreateOrder(ctx context.Context, orderID string) error {
// 定义事务回调
txFunc := func(msg *mq.Message) (*mq.MessageState, error) {
// 1. 执行本地数据库事务
err := o.saveOrderToDB(orderID)
if err != nil {
return &mq.MessageState{State: mq.RollbackMessage}, nil
}
// 2. 事务成功,返回 Commit
return &mq.MessageState{State: mq.CommitMessage}, nil
}
// 3. 发送事务消息
msg := &mq.Message{
Body: []byte(fmt.Sprintf("order_id:%s", orderID)),
}
_, err := o.producer.SendMessageInTransaction(ctx, msg, txFunc)
if err != nil {
log.Printf("Send transactional message failed: %v", err)
return err
}
return nil
}
func (o *OrderService) saveOrderToDB(orderID string) error {
// 模拟数据库操作
fmt.Println("Saving order to DB:", orderID)
return nil
}
消费者如何处理消息以确保幂等性
消费者端需要实现一个监听器,订阅特定的 Topic。当收到消息时,首先检查该消息是否已经处理过,通常通过查询数据库中的唯一键(如订单号)来判断。如果已存在,则直接忽略,避免重复处理导致的数据错误。如果未处理,则执行业务逻辑,例如扣减库存或更新账户余额。处理完成后,必须向 MQ 发送确认信号(Ack),告知消息已成功消费。如果在处理过程中发生异常,应记录日志并根据策略选择重试或进入死信队列。这种设计确保了即使网络抖动或服务重启,也不会造成数据不一致。

package main
import (
"context"
"fmt"
"log"
"github.com/zeromicro/go-zero/core/mq"
)
type InventoryService struct {
consumer mq.Consumer
}
func (i *InventoryService) StartConsumer(ctx context.Context) error {
handler := func(msg *mq.Message) error {
// 解析消息体
orderID := parseOrderID(string(msg.Body))
// 1. 幂等性检查
if i.isOrderProcessed(orderID) {
return nil // 已处理,直接返回成功
}
// 2. 执行业务逻辑
err := i.deductInventory(orderID)
if err != nil {
log.Printf("Deduct inventory failed for order %s: %v", orderID, err)
return err // 返回错误触发重试
}
// 3. 标记为已处理
i.markAsProcessed(orderID)
return nil
}
// 启动消费者
return i.consumer.Start(ctx, handler)
}
func (i *InventoryService) isOrderProcessed(orderID string) bool {
// 查询数据库判断是否已处理
return false
}
func (i *InventoryService) deductInventory(orderID string) error {
fmt.Println("Deducting inventory for order:", orderID)
return nil
}
func (i *InventoryService) markAsProcessed(orderID string) {
fmt.Println("Marking order as processed:", orderID)
}
func parseOrderID(body string) string {
return body
}
本地事务失败时消息会如何处理
当本地事务执行失败时,回调函数会返回 mq.RollbackMessage。此时,Go-Zero 的 MQ 客户端不会向消费者发送该消息。但是,这并不意味着消息永久丢失。Go-Zero 通常会配合定时任务或后台作业,定期扫描那些处于“待确认”状态的消息。如果发现某条消息在超时时间内仍未收到消费者的 Ack,或者本地事务标记为回滚但消息仍存在于中间件的状态表中,系统可以将其重新投递或转入死信队列进行人工干预。这种机制防止了因本地事务失败而导致的消息静默丢失,确保了数据的完整性。


















