.NET 5中MassTransit配置时IServiceCollectionConfigurator无UsingRabbitMq方法报错

核心原因 #

你使用的MassTransit 5.3.2版本不支持UsingRabbitMq扩展方法，这个API是MassTransit v6及以上版本才引入的新配置范式，v5.x采用的是完全不同的配置写法。

解决方案一：适配MassTransit 5.3.2的旧版配置写法 #

把现有AddMassTransit的代码替换为v5的配置方式，同时调整命名空间：

修改代码 #

public void ConfigureServices(IServiceCollection services)
{
    serviceSettings = Configuration.GetSection(nameof(ServiceSettings)).Get<ServiceSettings>();

    services.AddMassTransit(x =>
    {
        // 这里可以添加消费者、定义等，比如x.AddConsumer<YourConsumer>();
    });

    services.AddSingleton(provider => Bus.Factory.CreateUsingRabbitMq(cfg =>
    {
        var rabbitMQSettings = Configuration.GetSection(nameof(RabbitMqSettings)).Get<RabbitMqSettings>();
        cfg.Host(rabbitMQSettings.Host);
        
        // 配置端点（v5的写法）
        cfg.ConfigureEndpoints(provider, new KebabCaseEndpointNameFormatter(serviceSettings.ServiceName, false));
    }));

    services.AddSingleton<IBus>(provider => provider.GetRequiredService<IBusControl>());
}

调整命名空间 #

移除无效的命名空间，添加正确的v5 RabbitMQ引用：

// 移除无效命名空间
// using MassTransit.RabbitMqTransport.Hosting;
// 添加v5专属RabbitMQ命名空间
using MassTransit.RabbitMqTransport;

解决方案二：升级MassTransit到兼容.NET 5的版本（推荐） #

.NET 5兼容MassTransit v7.x系列（v8及以上不再支持.NET 5），升级后可继续使用UsingRabbitMq的新API：

修改csproj中的包引用 #

<ItemGroup>
    <!-- 替换为v7.x兼容版本，比如7.3.1 -->
    <PackageReference Include="MassTransit.AspNetCore" Version="7.3.1" />
    <PackageReference Include="MassTransit.RabbitMQ" Version="7.3.1" />
    <!-- MassTransit.AspNetCore已包含依赖注入扩展，移除单独引用 -->
    <!-- <PackageReference Include="MassTransit.Extensions.DependencyInjection" Version="5.3.2" /> -->
    <!-- 其他包保留 -->
    <PackageReference Include="MongoDB.Driver" Version="2.23.1" />
    <PackageReference Include="Swashbuckle.AspNetCore" Version="5.6.3" />
    <PackageReference Include="Microsoft.AspNetCore.Authentication.OpenIdConnect" Version="5.0.1" />
    <PackageReference Include="Swashbuckle.AspNetCore.Annotations" Version="5.0.0" />
    <PackageReference Include="Swashbuckle.AspNetCore.Filters" Version="5.0.0" />
</ItemGroup>

保留现有代码并调整命名空间 #

升级后仅需保留using MassTransit;即可，原有UsingRabbitMq代码可直接正常使用。

额外注意事项 #

• 若选择升级版本，需检查消费者、端点配置等是否有微小API变动（v6到v7的兼容性较好，大部分旧代码无需修改）。
• 清理项目的bin和obj目录，重新还原包，避免缓存导致的版本冲突。

内容的提问来源于stack exchange，提问作者Jonas Jørgensen