ASP.NET Core 6：配置UseDefaultFiles时排除/graphql/路径的问题

问题根源 #

你遇到的核心问题是UseDefaultFiles中间件会提前拦截所有带尾部斜杠的目录请求（比如/graphql/），将其重写为/graphql/index.html——而这个文件不存在，最终触发MapFallbackToFile返回SPA的index.html，完全跳过了GraphQL端点的匹配。

两种可行解决方案 #

方案一：条件化应用静态文件中间件 #

只在请求路径不以/graphql/开头时，才启用UseDefaultFiles和UseStaticFiles，直接排除GraphQL路径的拦截：

app.UseCors(...);
app.UseRouting();

// 仅对非GraphQL路径应用静态文件相关中间件
app.MapWhen(context => !context.Request.Path.StartsWithSegments("/graphql"), appBuilder =>
{
    appBuilder.UseDefaultFiles(new DefaultFilesOptions
    {
        RequestPath = "",
        FileProvider = fileProvider
    });
    appBuilder.UseStaticFiles(staticFileOptions);
});

// 配置端点：优先处理GraphQL，再处理控制器，最后兜底SPA
app.UseEndpoints(endpoints =>
{
    // 显式指定路径确保匹配带斜杠的/graphql/
    endpoints.MapGraphQL("/graphql/");
    endpoints.MapDefaultControllerRoute();
    endpoints.MapFallbackToFile("/index.html", new StaticFileOptions
    {
        RequestPath = "",
        FileProvider = fileProvider
    });
});

方案二：调整中间件顺序，让端点先匹配 #

ASP.NET Core的中间件是管道式执行的，让UseEndpoints先运行，这样GraphQL端点会优先匹配请求，不会走到后面的静态文件中间件：

app.UseCors(...);
app.UseRouting();

// 先执行端点匹配：GraphQL请求会被直接处理，不会进入后续中间件
app.UseEndpoints(endpoints =>
{
    endpoints.MapGraphQL("/graphql/"); // 显式指定带斜杠的路径
    endpoints.MapDefaultControllerRoute();
    endpoints.MapFallbackToFile("/index.html", new StaticFileOptions
    {
        RequestPath = "",
        FileProvider = fileProvider
    });
});

// 仅处理未被端点匹配的请求
app.UseDefaultFiles(new DefaultFilesOptions
{
    RequestPath = "",
    FileProvider = fileProvider
});
app.UseStaticFiles(staticFileOptions);

额外注意事项 #

• 确保GraphQL端点能匹配带尾部斜杠的路径：要么显式指定/graphql/作为路由，要么在GraphQL服务配置中允许尾部斜杠（比如ConfigureEndpoint(options => options.RoutePattern = "/graphql{/}")）。
• 不要在UseDefaultFiles中设置过宽的RequestPath，避免意外拦截其他端点路径。

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