Blazor项目配置指定非静态文件夹不由Blazor处理的方法

核心逻辑 #

Blazor的路由匹配中间件在ASP.NET Core管道中处于靠后位置，只需要将自定义处理器的注册放到Blazor相关中间件之前，指定匹配对应文件夹的路径前缀，即可让该路径下的所有请求优先走自定义处理器，不会被Blazor接管。

具体操作步骤 #

步骤1：调整Program.cs的中间件注册顺序 #

打开项目根目录的Program.cs文件，在Blazor相关中间件注册之前，添加你自定义的处理器逻辑，示例如下：

var builder = WebApplication.CreateBuilder(args);
// 省略原有服务注册逻辑，保持不变

var app = builder.Build();
// 省略Https重定向、静态文件等原有中间件，保持原有顺序不变

// --- 在此处添加自定义处理器，位置必须在Blazor相关中间件之前 ---
// 假设你要处理的文件夹路径前缀为 /custom-dir
app.Map("/custom-dir", appBuilder =>
{
    // 替换为你自己的业务处理逻辑
    appBuilder.Use(async (context, next) =>
    {
        // 示例：直接返回自定义响应内容
        context.Response.ContentType = "text/plain; charset=utf-8";
        await context.Response.WriteAsync("自定义处理器返回的响应内容");
        // 不需要调用next()，处理完成后直接结束请求，不会传递到后面的Blazor中间件
    });
});

// --- 原有Blazor相关中间件保持位置不变 ---
// Blazor Server 版本的原有配置：
app.MapBlazorHub();
app.MapFallbackToPage("/_Host");

// 如果是Blazor WebAssembly 托管模式，原有配置为：
// app.MapFallbackToFile("index.html");

app.Run();

步骤2：规则验证 #

项目启动后，访问/custom-dir路径下的任意地址，都会优先触发你注册的自定义处理器，不会进入Blazor的路由匹配逻辑，也不会返回Blazor的默认页面内容。

注意事项 #

如果你的自定义文件夹路径和wwwroot下的静态文件夹重名，需要给静态文件中间件添加排除规则，避免静态文件中间件优先处理了该路径的请求：

app.UseStaticFiles(new StaticFileOptions
{
    OnPrepareResponse = ctx =>
    {
        if (ctx.Context.Request.Path.StartsWithSegments("/custom-dir"))
        {
            // 跳过静态文件处理，将请求传递给后续自定义处理器
            ctx.Context.Response.StatusCode = 404;
            ctx.Context.Response.ContentLength = null;
        }
    }
});

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