如何为端点配置差异化特定路径？Blazor Server路由权限配置问题

异常原因解析 #

触发InvalidOperationException的核心原因是两个MapFallbackToPage端点的优先级完全一致。Blazor中MapFallbackToPage的默认优先级为0，当路由系统检测到多个同优先级的 fallback 端点时，无法确定请求应匹配哪一个，因此抛出冲突异常。

可行解决方案 #

方案1：提升公开端点优先级 #

通过指定更高的优先级值，让/public路径的端点优先被匹配：

// 配置/public路径的公开端点，优先级设为1（高于默认的0）
app.MapFallbackToPage("/_Host")
   .Add(endpointBuilder => endpointBuilder.Metadata.Add(new RouteEndpointMetadata(1)))
   .Where(ctx => ctx.Request.Path.StartsWithSegments("/public"))
   .AllowAnonymous();

// 全局其他路径强制要求授权，使用默认优先级0
app.MapFallbackToPage("/_Host").RequireAuthorization();

方案2：用MapWhen拆分路由分支 #

通过MapWhen按路径前缀拆分路由上下文，清晰分离公开与授权区域：

// 拦截所有/public开头的请求，配置为公开访问
app.MapWhen(ctx => ctx.Request.Path.StartsWithSegments("/public"), publicApp =>
{
    publicApp.MapFallbackToPage("/_Host").AllowAnonymous();
});

// 处理剩余所有请求，强制要求授权
app.MapFallbackToPage("/_Host").RequireAuthorization();

端点路由核心机制说明 #

• 优先级排序规则：所有注册的端点会根据RouteEndpointMetadata中的优先级值排序，数值越大优先级越高。请求到来时，路由系统会优先匹配高优先级的端点。
• Fallback端点的特殊性：MapFallbackToPage属于 fallback 类型端点，仅在没有更具体的端点匹配时才会生效。但如果存在多个同优先级的 fallback，路由系统无法完成决策，就会触发异常。
• 匹配逻辑流程：请求进入后，路由系统按优先级从高到低遍历所有端点，找到第一个符合路径匹配规则的端点并执行。因此，要让公开路径的请求被优先处理，要么提升其优先级，要么通过路径分支提前拦截。

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