.NET 8中如何设置或覆盖Blazor默认Hub选项？

问题背景 #

在.NET 8中尝试设置Blazor默认Hub选项时，按照文档在app.MapRazorComponents后添加app.MapBlazorHub()配置，会触发多端点匹配错误（AmbiguousMatchException），提示请求匹配了多个端点。沿用.NET 6的UseEndpoints方式也会出现相同错误。

原因分析 #

.NET 8的MapRazorComponents<T>()方法在添加交互式渲染模式（比如AddInteractiveServerRenderMode）时，会自动注册默认的Blazor Hub端点（路径为/_blazor）。此时手动调用MapBlazorHub()会重复注册同一路径的端点，导致路由冲突。

而.NET 6中MapRazorComponents不会自动注册Hub，必须手动调用MapBlazorHub，因此不会出现冲突。

解决方案 #

以下是三种可行的解决方式，推荐优先使用前两种：

1. 在交互式渲染模式配置中直接设置Hub选项 #

这是最贴合.NET 8新范式的方法，直接在AddInteractiveServerRenderMode的配置里修改Hub参数：

var builder = WebApplication.CreateBuilder(args);

// 添加服务
builder.Services.AddRazorComponents()
   .AddInteractiveServerRenderMode();

var app = builder.Build();

// 中间件配置
app.MapRazorComponents<App>()
   .AddInteractiveServerRenderMode(options =>
   {
       // 设置Hub选项
       options.HubOptions.TransportSendTimeout = TimeSpan.FromMinutes(5);
   });

app.Run();

2. 全局配置SignalR Hub选项 #

如果需要对所有SignalR Hub（包括Blazor的默认Hub）统一设置参数，可以在服务注册阶段配置：

var builder = WebApplication.CreateBuilder(args);

// 全局配置SignalR选项
builder.Services.AddSignalR(options =>
{
    options.TransportSendTimeout = TimeSpan.FromMinutes(5);
});

builder.Services.AddRazorComponents()
   .AddInteractiveServerRenderMode();

var app = builder.Build();

// 中间件配置
app.MapRazorComponents<App>()
   .AddInteractiveServerRenderMode();

app.Run();

3. 禁用自动注册并手动指定Hub（不推荐） #

如果必须手动调用MapBlazorHub，需要先禁用自动注册的Hub，同时修改客户端的Hub连接路径（否则客户端会找不到Hub）：

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorComponents()
   .AddInteractiveServerRenderMode();

var app = builder.Build();

// 禁用自动注册的Blazor Hub
app.MapRazorComponents<App>()
   .AddInteractiveServerRenderMode(options =>
   {
       options.DisableAutoHubRegistration = true;
   });

// 手动注册自定义路径的Hub
app.MapBlazorHub("/custom-blazor-hub", options =>
{
    options.TransportSendTimeout = TimeSpan.FromMinutes(5);
});

app.Run();

注意：此方法需要同步修改客户端配置，比如在客户端的Program.cs中指定Hub路径：

builder.Services.AddSignalR()
   .AddHubConnectionBuilder()
   .WithUrl("/custom-blazor-hub");

内容的提问来源于stack exchange，提问作者Ozzy