ASP.Net Core Razor混合Blazor WASM配置通配URL后Blazor失效问题

路由注册顺序和通配规则范围共同导致了冲突：

1. 你给Razor Pages配置的{*url}通配路由没有做路径排除，会匹配所有请求路径，包括/admin开头的后台地址
2. 原代码中Razor Pages的映射顺序在Blazor后台fallback规则之前，路由匹配按注册顺序优先执行，所有请求先被通配Razor页拦截，Blazor的资源加载、路由fallback完全不会触发
3. 原代码中UseBlazorFrameworkFiles()未指定Blazor应用的部署前缀/admin，即使路由不冲突，框架也会到站点根目录找Blazor运行时资源，导致加载失败

核心逻辑是单独划分/admin前缀的请求管道分支，给后台路由设置最高匹配优先级，同时给主站通配路由增加约束排除后台路径，修改后的Program.cs代码如下：

var builder = WebApplication.CreateBuilder(args);

// 注册Razor Pages服务时给通配路由加正则约束，排除所有/admin开头的路径
builder.Services.AddRazorPages(options =>
{
    options.Conventions.AddPageRoute("/Dynamic/index", "{*url:regex(^(?!admin/).*$)}");
});

var app = builder.Build();

// 基础异常和调试配置
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
}
else
{
    app.UseWebAssemblyDebugging();
}

// 根目录静态资源加载
app.UseStaticFiles();

// 优先单独处理/admin前缀的所有后台请求，独立走Blazor管道
app.MapWhen(ctx => ctx.Request.Path.StartsWithSegments("/admin"), adminPipeline =>
{
    // 指定Blazor应用的部署前缀为/admin，正确加载_blazor目录下的运行时资源
    adminPipeline.UseBlazorFrameworkFiles("/admin");
    adminPipeline.UseStaticFiles();
    adminPipeline.UseRouting();
    adminPipeline.UseAuthorization();
    // 后台非文件请求统一返回Blazor WASM入口文件
    adminPipeline.MapFallbackToFile("admin/{*path:nonfile}", "admin/index.html");
});

// 主站路由配置
app.UseRouting();
app.UseAuthorization();
// 注册主站Razor Pages路由，仅处理未被/admin分支拦截的请求
app.MapRazorPages();

app.Run();

部署注意：发布Blazor WASM项目后，需要把发布产物全部拷贝到主站wwwroot/admin目录下，保证后台静态资源路径和配置的前缀一致，避免出现404错误。

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