如何仅映射现有Blazor页面到管道，避免无效路由触发SignalR？

核心痛点 #

Blazor Server默认通过app.MapFallbackToPage("/_Host");会让所有未匹配的请求进入Blazor应用，哪怕是无效路由也会建立SignalR连接，无法直接返回静态404页面或Razor页面。要彻底避免这种情况，关键是让服务器提前区分「属于Blazor的路由」和「无效路由」，只让前者走/_Host，后者直接返回404。

最优解决方案：自动收集Blazor路由注册回退 #

手动逐个注册Blazor路由工作量大且易出错，通过反射自动收集所有Blazor组件的@page路由，批量注册回退规则，最后设置全局404回退，就能完美解决问题。

步骤1：编写路由收集扩展方法 #

创建一个扩展类，用反射遍历所有Blazor组件的路由属性：

using System.Reflection;
using Microsoft.AspNetCore.Components;

public static class BlazorRouteExtensions
{
    public static void MapBlazorFallbackRoutes(this IEndpointRouteBuilder endpoints, string hostPagePath)
    {
        // 获取当前程序集中的所有Blazor组件
        var componentTypes = Assembly.GetExecutingAssembly()
            .GetTypes()
            .Where(t => t.IsSubclassOf(typeof(ComponentBase)) && !t.IsAbstract);

        foreach (var componentType in componentTypes)
        {
            // 获取组件上的所有路由模板
            var routeAttributes = componentType.GetCustomAttributes<RouteAttribute>();
            foreach (var routeAttr in routeAttributes)
            {
                var routeTemplate = routeAttr.Template.TrimStart('/');
                // 处理根路由（@page "/"）
                var fallbackRoute = string.IsNullOrEmpty(routeTemplate) 
                    ? "~/{*clientroutes:nonfile}" 
                    : $"~/{routeTemplate}/{{*clientroutes:nonfile}}";

                // 注册该路由及子路径的回退规则
                endpoints.MapFallbackToPage(fallbackRoute, hostPagePath);
                
                // 单独注册路由本身（避免子路径规则漏掉根路由匹配）
                if (!string.IsNullOrEmpty(routeTemplate))
                {
                    endpoints.MapFallbackToPage($"~/{routeTemplate}", hostPagePath);
                }
            }
        }

        // 注册根路径的回退（匹配直接访问域名的情况）
        endpoints.MapFallbackToPage("~/", hostPagePath);
    }
}

步骤2：在Program.cs中使用扩展方法 #

按顺序注册端点，确保全局404回退放在最后：

var builder = WebApplication.CreateBuilder(args);

// 常规服务注册
builder.Services.AddRazorPages();
builder.Services.AddServerSideBlazor();

var app = builder.Build();

// 中间件配置
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();
app.UseRouting();

// 先注册API、Razor页面等端点
app.MapControllers();
app.MapRazorPages();

// 自动注册Blazor路由的回退规则
app.MapBlazorFallbackRoutes("/_Host");

// 最后设置全局无效路由的回退（指向Razor页面或静态文件）
app.MapFallbackToPage("/NotFound"); 
// 若用静态文件则改为：app.MapFallbackToFile("NotFound.html");

app.Run();

备选方案：手动维护路由列表 #

如果不想用反射（比如对性能有顾虑，或路由极少），可以把Blazor路由集中维护在一个静态类中，批量注册：

// 静态路由列表
public static class BlazorDefinedRoutes
{
    public static readonly string[] Routes = {
        "/Admin",
        "/SomeRoute/More",
        "/SomePage"
    };
}

// Program.cs中使用
foreach (var route in BlazorDefinedRoutes.Routes)
{
    // 注册路由及子路径的回退
    app.MapFallbackToPage($"{route}/{{*clientroutes:nonfile}}", "/_Host");
    // 注册路由本身
    app.MapFallbackToPage(route, "/_Host");
}

// 全局404回退
app.MapFallbackToPage("/NotFound");

关键原理说明 #

ASP.NET Core的端点匹配是按注册顺序执行的：

1. 先匹配API、Razor页面等明确的端点
2. 再匹配自动收集/手动注册的Blazor路由回退规则，只有符合Blazor路由的请求才会进入/_Host
3. 最后匹配全局404回退，所有未被前面规则匹配的请求直接返回404页面，完全不会触发Blazor的SignalR连接

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