ASP.NET Core静态文件：请求文件不存在时如何按扩展名返回默认文件？

我明白你的需求——当用户请求不存在的图片等静态资源时，你希望返回标准的404错误，而不是跳转到default.html页面。下面根据不同的应用场景给出具体的解决方案：

场景1：普通Web应用（非SPA） #

如果你只是搭建普通的静态文件服务，没有使用SPA框架（比如React、Vue），问题通常出在中间件的配置或顺序上。默认情况下，UseDefaultFiles只会处理目录请求（比如访问根目录/），但如果你的中间件顺序不对，或者配置有误，可能导致不存在的文件请求被导向默认文档。

推荐使用UseFileServer来整合默认文档和静态文件服务，它会自动处理目录请求的默认文档，同时对不存在的具体文件返回404：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    // 替换单独的UseDefaultFiles和UseStaticFiles
    app.UseFileServer(new FileServerOptions
    {
        EnableDefaultFiles = true, // 启用默认文档（default.html等）
        StaticFileOptions = new StaticFileOptions
        {
            // 可选：添加静态文件的缓存策略等配置
            OnPrepareResponse = ctx =>
            {
                // 这里可以添加缓存头，比如设置静态文件缓存30天
                ctx.Context.Response.Headers.Append(
                    "Cache-Control", "public, max-age=2592000");
            }
        }
    });

    // 其他中间件配置（比如UseMvc等）放在后面
}

这样配置后：

• 访问/时会返回wwwroot/default.html
• 访问/mypic.jpg如果文件存在则返回图片，不存在则直接返回404

场景2：SPA应用（使用UseSpa中间件） #

如果你是SPA应用，通常会有UseSpa中间件，它会捕获所有未被前面中间件处理的请求，返回SPA的默认页面（也就是你的default.html）。这时候需要让静态文件请求优先处理，且不存在的静态文件直接返回404，不进入SPA中间件。

可以通过在UseStaticFiles中添加自定义逻辑来实现：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    // 配置静态文件服务，添加不存在文件的处理逻辑
    app.UseStaticFiles(new StaticFileOptions
    {
        OnPrepareResponse = ctx =>
        {
            var webHostEnv = ctx.Context.RequestServices.GetRequiredService<IWebHostEnvironment>();
            // 获取请求对应的文件信息
            var fileInfo = webHostEnv.WebRootFileProvider.GetFileInfo(ctx.Context.Request.Path);
            
            // 如果文件不存在，返回404并终止中间件管道
            if (!fileInfo.Exists)
            {
                ctx.Context.Response.StatusCode = StatusCodes.Status404NotFound;
                ctx.Context.Response.ContentLength = 0;
                ctx.Context.Response.Body = Stream.Null;
            }
        }
    });

    // 启用默认文档（如果需要访问根目录返回default.html）
    app.UseDefaultFiles();

    // SPA中间件放在最后，只处理非静态资源的请求
    app.UseSpa(spa =>
    {
        spa.Options.DefaultPage = "/default.html";
        // 你的SPA其他配置，比如React的开发服务器等
    });
}

另外，也可以在静态文件中间件之后、SPA中间件之前添加一个自定义中间件，专门拦截带扩展名的不存在文件请求：

app.UseStaticFiles();

// 自定义中间件：拦截不存在的静态文件请求
app.Use(async (context, next) =>
{
    var requestPath = context.Request.Path;
    // 检查请求路径是否包含文件扩展名
    if (!string.IsNullOrEmpty(Path.GetExtension(requestPath)))
    {
        var webHostEnv = context.RequestServices.GetRequiredService<IWebHostEnvironment>();
        var fileInfo = webHostEnv.WebRootFileProvider.GetFileInfo(requestPath);
        
        if (!fileInfo.Exists)
        {
            // 返回404，不继续执行后续中间件
            context.Response.StatusCode = StatusCodes.Status404NotFound;
            return;
        }
    }

    // 正常请求继续往下走
    await next();
});

app.UseDefaultFiles();
app.UseSpa(...);

关键注意点 #

• 中间件顺序很重要：UseStaticFiles和UseDefaultFiles必须在任何会返回default.html的中间件（比如UseSpa、UseMvc的fallback路由）之前。
• UseDefaultFiles只是重写请求路径到默认文档，实际的文件服务还是由UseStaticFiles提供，所以UseDefaultFiles要放在UseStaticFiles之前。

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