.NET 8中MapFallbackToFile遇URL末尾含点时失效的问题

问题原因 #

当请求URL的最后一段包含多个点（如fi.le）时，静态文件中间件会将其视为带扩展名的文件请求。默认情况下，若对应的物理文件不存在，中间件会直接返回404状态码，不会将请求传递到后续的MapFallbackToFile端点，导致兜底逻辑失效。

解决方法 #

方法1：调整静态文件中间件配置，允许请求流转到兜底端点 #

修改UseStaticFiles的配置，让未找到的文件请求能继续向下传递，触发MapFallbackToFile：

public void ConfigureApp(IApplicationBuilder app, IWebHostEnvironment env) 
{
    app.UseHttpsRedirection();

    app.UseRouting();

    app.UseDefaultFiles();
    // 配置静态文件中间件，允许未找到的请求传递到后续逻辑
    app.UseStaticFiles(new StaticFileOptions
    {
        // 允许处理未知扩展名的文件请求，文件不存在时传递请求
        ServeUnknownFileTypes = true,
        // 设置默认内容类型，避免返回乱码
        DefaultContentType = "text/html"
    });

    app.UseEndpoints(builder => {
            builder.MapGet("/", context => {
                context.Response.Redirect($"/view/index.html{context.Request.QueryString}");
            });

            builder.MapFallbackToFile("/view/notFound.html");
    });
}

方法2：改用MapFallback自定义兜底逻辑 #

如果不想修改静态文件中间件的默认行为，直接使用MapFallback手动读取并返回404页面，确保所有未匹配的请求都能被处理：

public void ConfigureApp(IApplicationBuilder app, IWebHostEnvironment env) 
{
    app.UseHttpsRedirection();

    app.UseRouting();

    app.UseDefaultFiles();
    app.UseStaticFiles();

    app.UseEndpoints(builder => {
            builder.MapGet("/", context => {
                context.Response.Redirect($"/view/index.html{context.Request.QueryString}");
            });

            builder.MapFallback(async context =>
            {
                var notFoundFilePath = Path.Combine(env.WebRootPath, "view", "notFound.html");
                if (File.Exists(notFoundFilePath))
                {
                    context.Response.ContentType = "text/html";
                    await context.Response.SendFileAsync(notFoundFilePath);
                }
                else
                {
                    context.Response.StatusCode = StatusCodes.Status404NotFound;
                    await context.Response.WriteAsync("404 Not Found");
                }
            });
    });
}

关于MapFallbackToFile的适用性 #

MapFallbackToFile完全适合纯静态场景的404兜底需求。它是.NET为静态资源兜底专门设计的路由方法，会匹配所有未被前面端点（如MapGet、静态文件中间件）处理的请求，自动返回指定的静态文件。只要确保静态文件中间件不会拦截未找到的请求（如方法1的配置），它就能覆盖所有404场景。

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