Brighter 中的异步处理器

最新推荐文章于 2025-12-25 19:42:58 发布

原创最新推荐文章于 2025-12-25 19:42:58 发布 · 1.4k 阅读

34 ·

CC 4.0 BY-SA版权

文章标签：

#c# #.net #brighter #design pattern

简介

在分布式系统中，HTTP 请求、数据库查询和消息流等 I/O 操作是工作流的基础。虽然 .NET 的 async/await 模式能够高效管理这些操作，但与 Brighter 集成时需要显式配置异步处理器。本文将探讨如何在 Brighter 中启用异步请求处理器，并解释其设计背后的架构逻辑，这些逻辑基于 Reactor 和 Proactor 模式。

问题：未配置的异步处理器

在使用 Brighter 的 SqsSubscription 或 KafkaSubscription 时，若未正确配置即尝试使用 `RequestHandlerAsync`，会导致错误：

Paramore.Brighter.ConfigurationException: Error when building pipeline, see inner Exception for details
 ---> System.InvalidCastException: Unable to cast object of type 'GreetingHandler' to type 'Paramore.Brighter.IHandleRequests'.

这是因为 Brighter 默认使用 Reactor 模式（同步 I/O），无法推断您的处理器是否需要 Proactor 模式（异步 I/O）。

解决方案：启用异步处理

通过在订阅配置中显式设置 `isAsync: true` 解决此问题：

.AddServiceActivator(opt =>
{
    opt.Subscriptions = [
        new SqsSubscription<Greeting>(
            new SubscriptionName("greeting-subscription"), // 可选
            new ChannelName("greeting-queue"), // SQS 队列名称
            new RoutingKey("greeting.topic".ToValidSNSTopicName()), // SNS 主题名称
            bufferSize: 2,
            isAsync: true // 启用异步处理
        )
    ];
    opt.ChannelFactory = new ChannelFactory(connection);
});

这允许使用 RequestHandlerAsync 进行非阻塞 I/O：

public class GreetingHandler(ILogger<GreetingHandler> logger) : RequestHandlerAsync<Greeting>
{
    public override Task<Greeting> HandleAsync(Greeting command)
    {
        logger.LogInformation("Processing {Name}", command.Name);
        await Task.Delay(1_000);  // 模拟异步 I/O（如 HTTP 调用）
        logger.LogInformation("Hello {Name}", command.Name);
        return await base.HandleAsync(command);
    }
}