ASP.NET Core使用app.useSpa()访问.aspx 404页面报错如何解决

这个异常的核心原因是app.UseSpa()默认逻辑会在无其他中间件处理请求时，尝试返回/index.html，如果找不到对应文件或者请求匹配规则异常就会抛出错误，可通过以下配置调整：

• 先在app.UseSpa()前插入自定义中间件，过滤.aspx后缀请求或统一处理未匹配路由：

app.Use(async (context, next) =>
{
    // 匹配所有.aspx后缀的请求
    if (context.Request.Path.Value.EndsWith(".aspx", StringComparison.OrdinalIgnoreCase))
    {
        // 可选方案1：重定向到Angular自定义404路由，不会走到后续UseSpa逻辑
        context.Response.Redirect("/custom-404");
        return;

        // 可选方案2：如果需要这类请求走Angular路由，直接修改请求路径为index.html
        // context.Request.Path = "/index.html";
    }
    await next();
});

• 显式配置SPA静态文件与默认页路径，确保index.html能被中间件正常识别：

// 优先配置SPA静态文件规则，指定SPA资源存放路径
app.UseSpaStaticFiles(new StaticFileOptions
{
    FileProvider = new PhysicalFileProvider(
        Path.Combine(Directory.GetCurrentDirectory(), "ClientApp", "dist")
    )
});

app.UseSpa(spa =>
{
    spa.Options.SourcePath = "ClientApp";
    // 显式指定默认页路径，避免中间件路径匹配异常
    spa.Options.DefaultPage = "/index.html";
    
    // 开发环境Angular代理配置保留原有逻辑即可
    if (app.Environment.IsDevelopment())
    {
        spa.UseAngularCliServer(npmScript: "start");
    }
});

• 如果完全不需要处理.aspx请求，可直接在路由层拦截返回404，避免请求走到UseSpa中间件：

app.Map("/{*url}", context =>
{
    if (context.Request.Path.Value.EndsWith(".aspx", StringComparison.OrdinalIgnoreCase))
    {
        context.Response.StatusCode = 404;
        return Task.CompletedTask;
    }
    return Task.CompletedTask;
});

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