如何在Blazor WASM应用加载前运行服务器端中间件

要实现仅在SPA初始请求（包括深度链接）执行服务器端检查，而不影响API和静态资源请求，可以通过以下两种方式处理：

方法一：通过自定义中间件过滤请求 #

先判断当前请求是否为静态资源或API请求，仅对需要返回index.html的SPA初始请求执行检查。

1. 定义辅助方法区分请求类型：

private bool IsStaticFileOrApi(HttpContext ctx)
{
    var path = ctx.Request.Path.Value;
    
    // 过滤API路由（根据你的实际API前缀调整）
    if (path.StartsWith("/api/"))
        return true;
    
    // 过滤常见静态资源后缀，可根据项目需求扩展
    var staticExtensions = new[] { ".css", ".js", ".png", ".jpg", ".jpeg", ".gif", ".ico", ".svg", ".wasm" };
    return staticExtensions.Any(ext => path.EndsWith(ext, StringComparison.OrdinalIgnoreCase));
}

2. 修改自定义中间件，仅针对非静态/非API请求执行检查：

// 注意中间件顺序：要放在UseStaticFiles和UseBlazorFrameworkFiles之后，UseRouting之前
app.Use(async (ctx, next) =>
{
    if (!IsStaticFileOrApi(ctx))
    {
        if (!CheckIfClientExists(ctx))
        {
            ctx.Response.StatusCode = 404;
            return; // 直接返回404，不执行后续中间件
        }
    }
    await next();
});

方法二：利用MapFallback精准处理SPA入口请求 #

Blazor WASM通过MapFallbackToFile返回index.html处理所有客户端路由，我们可以改用MapFallback委托，直接在fallback逻辑中加入检查：

app.UseEndpoints(endpoints =>
{
    endpoints.MapControllers();
    
    endpoints.MapFallback(async context =>
    {
        // 仅在fallback到index.html的请求时执行检查
        if (!CheckIfClientExists(context))
        {
            context.Response.StatusCode = 404;
            return;
        }
        
        // 正常返回index.html
        var webRootPath = env.WebRootPath; // 需要注入IWebHostEnvironment
        await context.Response.SendFileAsync(Path.Combine(webRootPath, "index.html"));
    });
});

这种方式更精准，因为MapFallback只会处理未被其他端点（如API、静态文件）匹配的请求，也就是所有需要加载SPA的初始请求（包括深度链接），无需手动过滤请求类型。

注意事项 #

• 中间件顺序很重要：自定义中间件要放在UseStaticFiles和UseBlazorFrameworkFiles之后，确保静态资源请求已被处理，不会触发检查逻辑。
• 若使用MapFallback方式，需要在Startup/Program中注入IWebHostEnvironment来获取wwwroot路径。

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