MassTransit集成Azure Service Bus消息传输详解

乔如黎

于 2025-06-06 09:01:37 发布

阅读量246

点赞数 5

本文链接：https://blog.csdn.net/gitblog_00501/article/details/148464256

版权

MassTransit集成Azure Service Bus消息传输详解

MassTransit MassTransit/MassTransit: 一个基于 .NET 的分布式消息传递框架，提供了多种消息传递和分布式处理功能，适合用于实现分布式消息传递和处理。项目地址: https://gitcode.com/gh_mirrors/ma/MassTransit

一、Azure Service Bus概述

Azure Service Bus是微软Azure提供的企业级消息服务，为分布式系统提供可靠、安全的异步通信能力。作为MassTransit支持的核心传输组件之一，它实现了多种消息模式：

队列模式：点对点通信，确保消息被单个消费者处理
主题/订阅模式：发布/订阅模型，支持一对多消息分发
请求/响应模式：支持同步交互模式

高级特性包括：

分区功能提升吞吐量
自动伸缩应对流量波动
死信队列处理异常消息
会话保证消息顺序处理

二、拓扑结构配置

2.1 主题(Topic)配置

主题作为发布/订阅的核心实体，MassTransit提供了灵活的配置方式：

// 启用主题分区
cfg.Publish<OrderSubmitted>(x => 
{
    x.EnablePartitioning = true;
});

关键配置项：

EnablePartitioning：启用水平分区提升性能
MaxSizeInMB：设置主题存储容量
DefaultMessageTimeToLive：消息默认存活时间

2.2 分区键(PartitionKey)策略

对于需要保证顺序的消息，可设置分区键：

public record SubmitOrder
{
    public string CustomerId { get; init; }
    public Guid TransactionId { get; init; }
}

// 按客户ID分区
cfg.Send<SubmitOrder>(x =>
{
    x.UsePartitionKeyFormatter(context => context.Message.CustomerId);
});

最佳实践：

选择基数适中的分区键（如客户ID而非性别）
避免热点分区（如80%消息使用相同分区键）
结合业务场景设计分区策略

2.3 会话(Session)支持

会话保证相关消息的顺序处理：

public record UpdateUserStatus
{
    public Guid UserId { get; init; }
    public string Status { get; init; }
}

// 按用户ID分组会话
cfg.Send<UpdateUserStatus>(x =>
{
    x.UseSessionIdFormatter(context => context.Message.UserId);
});

会话典型场景：

用户操作流水线
设备控制指令序列
订单状态变更跟踪

2.4 全局拓扑配置

统一配置会话和分区键策略：

GlobalTopology.Send.TryAddConvention(new SessionIdSendTopologyConvention());
GlobalTopology.Send.TryAddConvention(new PartitionKeySendTopologyConvention());

GlobalTopology.Send.UseSessionIdFormatter<ICanHasSessionId>(x => x.Message.SessionId.ToString());

三、订阅管理

3.1 基础订阅模式

// 直接订阅主题
cfg.SubscriptionEndpoint<MessageType>("subscription-name", e =>
{
    e.ConfigureConsumer<MyConsumer>(provider);
})

3.2 队列转发模式

cfg.ReceiveEndpoint("input-queue", e =>
{
    e.Subscribe("topic-name");  // 订阅主题
    e.Subscribe<MessageType>(); // 订阅消息类型
})

3.3 高级订阅配置

cfg.ReceiveEndpoint("input-queue", e =>
{
    e.Subscribe("topic-name", x =>
    {
        x.AutoDeleteOnIdle = TimeSpan.FromMinutes(60);
        x.DefaultMessageTimeToLive = TimeSpan.FromDays(7);
    });
})

3.4 订阅过滤器

// SQL过滤规则
cfg.ReceiveEndpoint("input-queue", e =>
{
    e.Subscribe("topic-name", x =>
    {
        x.Filter = new SqlRuleFilter("Amount > 1000");
    });
})

四、Saga状态机集成

4.1 禁用自动拓扑配置

public class OrderSagaStateMachine : MassTransitStateMachine<OrderSaga>
{
    public OrderSagaStateMachine()
    {
        Event(() => PaymentCompleted, x => x.ConfigureConsumeTopology = false);
    }
    
    public Event<PaymentCompleted> PaymentCompleted { get; }
}

4.2 自定义Saga订阅

public class OrderSagaDefinition : SagaDefinition<OrderSaga>
{
    protected override void ConfigureSaga(IReceiveEndpointConfigurator endpoint, 
        ISagaConfigurator<OrderSaga> sagaConfigurator)
    {
        if(endpoint is IServiceBusReceiveEndpointConfigurator sb)
        {
            sb.Subscribe<PaymentCompleted>("payments", x =>
            {
                x.Rule = new CreateRuleOptions("HighValue", 
                    new SqlRuleFilter("Amount > 5000"));
            });
        }
    }
}