MassTransit消息类继承/实现接口时泛型Send/Publish过滤器多次调用的解决方法
这是MassTransit的固有设计逻辑:它会为消息的所有可赋值类型(具体类、实现的接口、继承的基类)分别构建独立的管道分支,目的是支持针对不同层级的消息类型单独配置过滤器、消费逻辑等。使用UseSendFilter/UsePublishFilter注册开放泛型过滤器时,过滤器会被绑定到所有匹配泛型约束的管道分支上,因此每个类型层级都会触发一次实例化和调用。
另外接口上的[ExcludeFromTopology]特性仅会阻止接口拓扑(队列、主题)发布到Azure Service Bus,不会影响管道分支的构建,无法解决多次触发的问题。
根据使用场景,可选择以下任意一种方案:
方案1:过滤器内部加类型判断(适合全局统一注册场景)
直接在过滤器逻辑中判断当前上下文的消息是否为具体类型,非具体类型直接放行,仅保留一次执行。
修改SendFilterTest<T>的Send方法:
public async Task Send(SendContext<T> context, IPipe<SendContext<T>> next) { // 仅当当前管道分支的泛型类型等于消息实际类型时执行业务逻辑 if (typeof(T) == context.Message.GetType()) { // 此处编写元数据添加逻辑 _logger.LogInformation($"SendFilterInstance: {this.GetHashCode()}. MessageId: {context.MessageId}"); context.Headers.Set("X-Custom-Metadata", "your-value"); } await next.Send(context); }
该方案不需要修改原有注册逻辑,适配所有消息类型,缺点是会在每个类型分支上创建过滤器实例,仅不执行业务逻辑,有少量内存开销。
方案2:仅针对具体消息类型注册过滤器(适合少量消息类型场景)
不要注册开放泛型过滤器,仅针对需要处理的具体消息类型注册,从根源上避免接口/基类的管道分支加载过滤器。
修改原有注册代码:
// 原有开放泛型注册方式会触发所有分支: // cfg.UseSendFilter(typeof(SendFilterTest<>), context); // 改为仅针对具体消息类型注册 cfg.UseSendFilter(typeof(SendFilterTest<TestIntegrationCommand>), context); // 其余需要处理的具体消息类型,逐个追加注册即可
该方案完全不会在接口/基类分支上创建过滤器实例,性能最优,缺点是需要逐个注册所有需要处理的消息类型,不适合消息类型较多的场景。
方案3:改用发送/发布观察者实现统一元数据添加(适合全局统一加元数据场景)
如果需求是给所有发送/发布的消息加统一元数据,不需要针对特定消息类型做特殊逻辑,优先使用MassTransit内置的观察者机制。观察者仅会针对单次发送/发布操作触发一次,不会按类型分支重复执行。
示例实现:
- 实现
ISendObserver接口(发布逻辑则用IPublishObserver):
public class CustomGlobalSendObserver : ISendObserver { private readonly ILogger<CustomGlobalSendObserver> _logger; public CustomGlobalSendObserver(ILogger<CustomGlobalSendObserver> logger) { _logger = logger; } public Task PreSend<T>(SendContext<T> context) where T : class { // 仅触发一次,此处编写统一元数据逻辑 _logger.LogInformation($"PreSend MessageId: {context.MessageId}"); context.Headers.Set("X-Global-Metadata", "global-value"); return Task.CompletedTask; } // 其余接口方法按需实现,不需要的话直接返回CompletedTask即可 public Task PostSend<T>(SendContext<T> context) where T : class => Task.CompletedTask; public Task SendFault<T>(SendContext<T> context, Exception exception) where T : class => Task.CompletedTask; }
- 在总线配置中注册观察者:
// 在总线配置逻辑中添加 cfg.ConnectSendObserver(new CustomGlobalSendObserver(logger)); // 发布逻辑对应使用 ConnectPublishObserver 注册IPublishObserver实现
该方案是全局加元数据的最优解,没有冗余的实例化和执行开销。
内容的提问来源于stack exchange,提问作者Borja Fernández

