Blazor WASM如何配置路由支持未匹配控制器的POST请求返回index.html

根因说明 #

默认MapFallbackToFile方法仅处理GET和HEAD类型的请求，所以未匹配到控制器的POST请求无法触发回退逻辑。你之前自定义的MapPost逻辑不生效的原因是：UseStaticFiles中间件执行顺序在UseRouting之前，当请求进入端点执行阶段时，静态文件中间件已经完成了响应判断，此时再修改Request.Path也不会重新触发静态文件的读取逻辑。

解决方案 #

方法1：全HTTP方法回退（推荐） #

直接替换原有MapFallbackToFile配置，使用MapFallback定义匹配所有未处理请求、支持所有HTTP动词的回退规则，直接返回index.html文件：

app.UseEndpoints(endpoints =>
{
    endpoints.MapRazorPages();
    endpoints.MapControllers();
    // 全方法回退规则，覆盖GET/POST/PUT等所有请求类型
    endpoints.MapFallback(async context =>
    {
        context.Response.ContentType = "text/html";
        await context.Response.SendFileAsync(Path.Combine(app.Environment.WebRootPath, "index.html"));
    });
});

方法2：仅新增POST请求回退 #

如果不需要支持其他HTTP方法，只想在原有配置基础上补充POST请求的处理，可以保留原有MapFallbackToFile，新增POST的匹配规则：

app.UseEndpoints(endpoints =>
{
    endpoints.MapRazorPages();
    endpoints.MapControllers();
    endpoints.MapFallbackToFile("index.html");
    // 补充POST请求的回退处理
    endpoints.MapPost("{*path}", async context =>
    {
        context.Response.ContentType = "text/html";
        await context.Response.SendFileAsync(Path.Combine(app.Environment.WebRootPath, "index.html"));
    });
});

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