.NET 6中使用app.UseSpa时无法访问控制器方法的问题

我将.NET Core 2.1应用升级至.NET 6，仅迁移启动代码至Program类，其余代码保留。当前遇到的问题是：添加app.UseSpa后，所有URL都会重定向到Angular站点，无法访问控制器端点；移除app.UseSpa则控制器可正常访问。我尝试调整中间件顺序，但问题依旧，原本预期UseSpa在管道最后执行，会先匹配控制器路由，未匹配时才转向SPA。

问题分析 #

导致该问题的核心原因有两点：

1. .NET 6路由机制变化：WebApplication的路由系统简化了端点注册逻辑，若控制器路由映射的执行时机或中间件顺序不当，会被UseSpa中间件提前拦截请求。
2. 开发环境SPA代理干扰：UseAngularCliServer在开发环境会代理所有请求到Angular开发服务器，若未排除API/控制器路径，会导致控制器请求被劫持。

解决方案 #

1. 修正中间件顺序与授权逻辑 #

确保授权中间件在身份验证后执行，同时保证控制器路由映射在UseSpa之前执行（这是路由匹配优先级的关键）。

2. 配置Spa排除特定路径 #

通过SpaOptions设置拦截规则，排除API、控制器相关路径，避免这些请求被SPA接管。

修改后的ConfigurePipeline方法代码 #

private static void ConfigurePipeline(WebApplication app)
{
    app.UseHttpsRedirection();

    // 调整静态文件中间件顺序：先处理常规静态文件，再处理SPA静态文件
    app.UseStaticFiles();
    app.UseSpaStaticFiles();

    app.UseAuthentication();
    // 新增授权中间件，完善身份验证流程
    app.UseAuthorization();

    app.UseHangfireServer();
    app.UseHangfireDashboard();

    // 控制器路由映射必须在UseSpa之前执行，确保路由优先匹配
    app.MapControllerRoute(
        name: "default",
        pattern: "{controller}/{action=Index}/{id?}");

    RecurringJob.AddOrUpdate<UpdateStoresService>("UpdateStoresJob", service => service.UpdateStores(), "0 7-19 * * *",
        TimeZoneInfo.Local);

    app.UseSpa(spa =>
    {
        spa.Options.SourcePath = "ClientApp";

        // 配置排除规则，避免SPA拦截控制器/API请求
        spa.Options.DefaultPageStaticFileOptions = new StaticFileOptions
        {
            OnPrepareResponse = ctx =>
            {
                var requestPath = ctx.Context.Request.Path.Value;
                // 根据实际路由规则调整排除路径，比如API前缀、控制器名称
                if (requestPath.StartsWith("/api") || 
                    requestPath.StartsWith("/Home") || 
                    requestPath.StartsWith("/Account"))
                {
                    ctx.Context.Response.StatusCode = 404;
                }
            }
        };

        if (app.Environment.IsDevelopment())
        {
            spa.UseAngularCliServer(npmScript: "start");
        }
    });
}

额外优化建议 #

如果你的控制器使用[Route("api/[controller]")]这类API专属路由，建议替换MapControllerRoute为MapControllers()，更适配API场景：

// 替换原MapControllerRoute
app.MapControllers();

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