使用 RabbitMQ 和 Go 构建异步订单处理系统

spiker_2024-09-09 20:22

使用 RabbitMQ 和 Go 构建异步订单处理系统

我们可以通过构建一个订单处理系统来演示如何使用消息队列（MQ）实现异步任务处理。这个项目将使用 RabbitMQ 作为消息队列，并使用 Go 语言来实现。以下是项目的详细教程和相关环境配置。

项目描述

功能：模拟一个简单的电商订单处理系统，包括下单、库存扣减、邮件通知、以及发货通知。每个任务通过消息队列异步处理。

环境配置

1. 安装 Go 环境

确保已经安装 Go 语言开发环境，可以通过以下命令确认：

bash 复制代码 
go version

如果没有安装，可以从 Go 官方网站 下载并安装。
2. 安装 RabbitMQ

RabbitMQ 可以通过 Docker 轻松安装：

bash 复制代码 
docker run -d --hostname rabbitmq --name some-rabbit -p 5672:5672 -p 15672:15672 rabbitmq:3-management
RabbitMQ 管理控制台可以通过 http://localhost:15672 访问。
默认用户名和密码都是 guest。

3. 创建 Go 项目

bash 复制代码 
mkdir order-processing
cd order-processing
go mod init order-processing

4. 安装 RabbitMQ Go 客户端库

bash 复制代码 
go get github.com/streadway/amqp

项目结构

项目将包含以下文件和目录：

bash 复制代码 
order-processing/
│
├── main.go                 // 入口文件，初始化 MQ 连接
├── producer.go             // 生产者代码，模拟下单请求
├── consumer_inventory.go   // 消费者代码，处理库存扣减
├── consumer_email.go       // 消费者代码，处理邮件发送
└── consumer_shipping.go    // 消费者代码，处理发货通知

代码实现

1. main.go - 初始化 MQ 连接

go 复制代码 
package main

import (
    "log"
    "github.com/streadway/amqp"
)

func failOnError(err error, msg string) {
    if err != nil {
        log.Fatalf("%s: %s", msg, err)
    }
}

func main() {
    conn, err := amqp.Dial("amqp://guest:guest@localhost:5672/")
    failOnError(err, "Failed to connect to RabbitMQ")
    defer conn.Close()

    ch, err := conn.Channel()
    failOnError(err, "Failed to open a channel")
    defer ch.Close()

    // 声明队列
    q, err := ch.QueueDeclare(
        "order_queue", // 队列名称
        true,          // 持久化
        false,         // 自动删除
        false,         // 独占
        false,         // 无需等待
        nil,           // 额外属性
    )
    failOnError(err, "Failed to declare a queue")

    log.Printf(" [*] Waiting for messages. To exit press CTRL+C")
    
    // 创建消费者
    msgs, err := ch.Consume(
        q.Name, // 队列名称
        "",     // 消费者标识符
        true,   // 自动应答
        false,  // 独占
        false,  // 无需等待
        false,  // no local
        nil,    // 额外属性
    )
    failOnError(err, "Failed to register a consumer")

    forever := make(chan bool)

    go func() {
        for d := range msgs {
            log.Printf("Received a message: %s", d.Body)
        }
    }()

    <-forever
}

2. producer.go - 生产者代码

go 复制代码 
package main

import (
    "log"
    "github.com/streadway/amqp"
)

func failOnError(err error, msg string) {
    if err != nil {
        log.Fatalf("%s: %s", msg, err)
    }
}

func main() {
    conn, err := amqp.Dial("amqp://guest:guest@localhost:5672/")
    failOnError(err, "Failed to connect to RabbitMQ")
    defer conn.Close()

    ch, err := conn.Channel()
    failOnError(err, "Failed to open a channel")
    defer ch.Close()

    q, err := ch.QueueDeclare(
        "order_queue",
        true,
        false,
        false,
        false,
        nil,
    )
    failOnError(err, "Failed to declare a queue")

    body := "New Order"
    err = ch.Publish(
        "",
        q.Name,
        false,
        false,
        amqp.Publishing{
            ContentType: "text/plain",
            Body:        []byte(body),
        })
    failOnError(err, "Failed to publish a message")

    log.Printf(" [x] Sent %s", body)
}

3. consumer_inventory.go - 处理库存扣减

go 复制代码 
package main

import (
    "log"
    "github.com/streadway/amqp"
)

func failOnError(err error, msg string) {
    if err != nil {
        log.Fatalf("%s: %s", msg, err)
    }
}

func main() {
    conn, err := amqp.Dial("amqp://guest:guest@localhost:5672/")
    failOnError(err, "Failed to connect to RabbitMQ")
    defer conn.Close()

    ch, err := conn.Channel()
    failOnError(err, "Failed to open a channel")
    defer ch.Close()

    q, err := ch.QueueDeclare(
        "order_queue",
        true,
        false,
        false,
        false,
        nil,
    )
    failOnError(err, "Failed to declare a queue")

    msgs, err := ch.Consume(
        q.Name,
        "",
        true,
        false,
        false,
        false,
        nil,
    )
    failOnError(err, "Failed to register a consumer")

    forever := make(chan bool)

    go func() {
        for d := range msgs {
            log.Printf("Processing inventory for order: %s", d.Body)
            // 处理库存扣减逻辑
        }
    }()

    <-forever
}

4. consumer_email.go - 处理邮件发送

go 复制代码 
package main

import (
    "log"
    "github.com/streadway/amqp"
)

func failOnError(err error, msg string) {
    if err != nil {
        log.Fatalf("%s: %s", msg, err)
    }
}

func main() {
    conn, err := amqp.Dial("amqp://guest:guest@localhost:5672/")
    failOnError(err, "Failed to connect to RabbitMQ")
    defer conn.Close()

    ch, err := conn.Channel()
    failOnError(err, "Failed to open a channel")
    defer ch.Close()

    q, err := ch.QueueDeclare(
        "order_queue",
        true,
        false,
        false,
        false,
        nil,
    )
    failOnError(err, "Failed to declare a queue")

    msgs, err := ch.Consume(
        q.Name,
        "",
        true,
        false,
        false,
        false,
        nil,
    )
    failOnError(err, "Failed to register a consumer")

    forever := make(chan bool)

    go func() {
        for d := range msgs {
            log.Printf("Sending email for order: %s", d.Body)
            // 处理邮件发送逻辑
        }
    }()

    <-forever
}

5. consumer_shipping.go - 处理发货通知

go 复制代码 
package main

import (
    "log"
    "github.com/streadway/amqp"
)

func failOnError(err error, msg string) {
    if err != nil {
        log.Fatalf("%s: %s", msg, err)
    }
}

func main() {
    conn, err := amqp.Dial("amqp://guest:guest@localhost:5672/")
    failOnError(err, "Failed to connect to RabbitMQ")
    defer conn.Close()

    ch, err := conn.Channel()
    failOnError(err, "Failed to open a channel")
    defer ch.Close()

    q, err := ch.QueueDeclare(
        "order_queue",
        true,
        false,
        false,
        false,
        nil,
    )
    failOnError(err, "Failed to declare a queue")

    msgs, err := ch.Consume(
        q.Name,
        "",
        true,
        false,
        false,
        false,
        nil,
    )
    failOnError(err, "Failed to register a consumer")

    forever := make(chan bool)

    go func() {
        for d := range msgs {
            log.Printf("Notifying shipping for order: %s", d.Body)
            // 处理发货通知逻辑
        }
    }()

    <-forever
}

运行步骤

1.启动 RabbitMQ（如果使用 Docker 已启动，则跳过这步）。

bash 复制代码 
docker run -d --hostname rabbitmq --name some-rabbit -p 5672:5672 -p 15672:15672 rabbitmq:3-management

2.启动消费者：分别运行 consumer_inventory.go、consumer_email.go 和consumer_shipping.go文件。

3.发送订单消息：运行 producer.go 文件，模拟用户下单。

运行后的验证

1.消费者处理消息的日志输出：

每个消费者程序启动后，会开始监听 RabbitMQ 中相应的队列。当生产者发送消息时，消费者会从队列中读取消息，并输出处理的日志信息。
消费者处理消息的流程如下：
    consumer_inventory.go 处理库存更新的消息。
    consumer_email.go 处理订单确认邮件的发送。
    consumer_shipping.go 处理发货通知的消息。

你可以在每个运行的消费者窗口中看到相应的日志输出，例如：



2.RabbitMQ 管理界面监控： 通过访问 RabbitMQ 管理界面，你可以检查 RabbitMQ 队列的状态：

查看哪些队列正在运行。
检查队列中是否有消息积压。
查看消息的流入和流出情况，确保消费者正在从队列中消费消息。

项目中的关键点解释

RabbitMQ 消息模型：
    生产者会将消息发布到 RabbitMQ 的一个交换机（Exchange）上，交换机会将消息路由到相应的队列（Queue）。
    消费者监听队列并从中获取消息进行处理。每个消费者可以处理一个特定类型的消息。

AMQP协议：
    Go 代码中的 amqp 库基于 AMQP 协议（Advanced Message Queuing Protocol），这是 RabbitMQ 使用的消息协议。它定义了如何在生产者和消费者之间传递消息。

队列持久化与自动应答：
    RabbitMQ 队列可以配置为持久化消息，确保在系统重启时消息不会丢失。
    你可以在消费者中配置是否自动应答（acknowledgment），以确认消息处理成功后再从队列中移除。当前例子中是使用自动应答的模式。

问题排查

如果在运行过程中遇到问题，可以按以下步骤排查：

1.检查 RabbitMQ 是否正常运行：确保 Docker 容器正常运行，并且端口没有冲突。

bash 复制代码 
docker ps

如果 RabbitMQ 没有启动，可以通过命令 docker start some-rabbit 来启动。

2.确保消费者能够连接到 RabbitMQ：如果消费者无法连接到 RabbitMQ，可能是因为配置错误或 RabbitMQ 服务未启动。检查消费者的日志输出，确认连接是否成功。

3.查看 RabbitMQ 日志：通过 RabbitMQ 管理界面可以查看日志，排查是否有消息未路由到队列或者连接失败的错误。

通过这些步骤，你应该能够顺利运行和验证这个消息队列项目。如果有更多问题或需要其他帮助，随时告诉我！

总结

通过这篇博客，你应当掌握了 RabbitMQ 的基本使用方法，了解了如何将 RabbitMQ 与 Go 应用集成，从而构建可靠的消息传递系统。这些技能将为你在开发异步消息处理和微服务架构方面奠定坚实的基础。

相关推荐
一见你就笑i3 小时前
关于RabbitMQ重复消费的解决方案
分布式·面试·rabbitmq
小于负无穷4 小时前
Go 中 RPC 的使用教程
开发语言·后端·rpc·golang
忍界英雄13 小时前
学习笔记-Golang中的Context
笔记·学习·golang
Python私教16 小时前
Go语言现代web开发09 for 循环语句
java·算法·golang
扬子16 小时前
golang中连接达梦数据库使用域名来代替IP时会出现解析问题
开发语言·数据库·golang
GoppViper21 小时前
golang学习笔记20——golang微服务负载均衡的问题与解决方案
开发语言·笔记·后端·学习·微服务·golang·负载均衡
程序者王大川1 天前
【GO开发】MacOS上搭建GO的基础环境-Hello World
开发语言·后端·macos·golang·go
SCBAiotAigc1 天前
golang实现正向代理http_proxy和https_proxy
http·golang·https
__AtYou__1 天前
Golang | Leetcode Golang题解之第406题根据身高重建队列
leetcode·golang·题解
qq_485015211 天前
rabbitmq
分布式·rabbitmq
热门推荐
01RAG 实践- Ollama+RagFlow 部署本地知识库02组基轨迹建模 GBTM的介绍与实现（Stata 或 R）032024年高教社杯数学建模国赛C题超详细解题思路分析04yolov8实战第五天——yolov8+ffmpg实时视频流检测并进行实时推流——（推流，保姆教学）05Coze扣子平台完整体验和实践（附国内和国际版对比）06【2024数模国赛赛题思路公开】国赛B题思路丨附可运行代码丨无偿自提07【经验分享】Ubuntu22.04安装微信(linux官方版)08苍穹外卖面试总结09【2024高教社杯全国大学生数学建模竞赛】B题 生产过程中的决策问题——解题思路 代码 论文10Ubuntu24.04安装中文输入法