配置.NET Core 3+Http.sys+URLPrefix部署React SPA页面错误求助

我之前也碰到过完全相同的场景——给应用加了非根路径的URL前缀后，SPA中间件死活找不到/index.html。本质原因是我们设置了/Product/Site作为URL前缀，但静态文件中间件和SPA中间件还在按根路径(/)来查找文件和处理路由，导致路径不匹配。下面是我亲测有效的配置调整方案：

1. 配置SPA静态文件的请求路径前缀 #

在ConfigureServices的AddSpaStaticFiles中，添加RequestPath配置，让静态文件中间件知道要处理/Product/Site前缀下的静态资源请求：

public override void ConfigureServices(IServiceCollection services) {
    services.AddRazorPages();
    services.AddSpaStaticFiles(configuration => {
        configuration.RootPath = "ClientApp/build";
        // 新增：指定静态文件的请求路径前缀，匹配URLPrefix的路径部分
        configuration.RequestPath = "/Product/Site";
    });
    services.AddMvc();
    services.AddResponseCompression(opts => {
        opts.MimeTypes = ResponseCompressionDefaults.MimeTypes.Concat(
            new[] { "application/octet-stream" });
    });
}

2. 调整SPA中间件的基础路径与默认页面 #

在Configure的UseSpa中，更新DefaultPage为带前缀的路径，并设置BasePath让SPA中间件识别基础路径：

app.UseSpa(spa => {
    // 修改默认页面路径，带上URL前缀
    spa.Options.DefaultPage = "/Product/Site/index.html";
    spa.Options.SourcePath = "ClientApp";
    // 新增：指定SPA的基础路径，确保路由和资源加载正确
    spa.Options.BasePath = "/Product/Site";
});

3. 全局设置请求基础路径（关键步骤） #

在UseRouting之前添加UsePathBase，告诉整个应用所有请求都以/Product/Site作为基础路径，这样路由、静态文件、SPA中间件都会统一基于这个前缀处理：

// 在UseRouting前添加这一行
app.UsePathBase("/Product/Site");

app.UseRouting();
app.UseEndpoints ( endpoints => {
    endpoints.MapControllerRoute(
        name: "default",
        pattern: "{controller}/{action=Index}/{id?}");
} );

为什么这些配置有效？ #

• UsePathBase：相当于给整个应用加了一个"路径前缀过滤器"，所有进来的请求都会先去掉/Product/Site前缀再交给后续中间件处理，同时响应时会自动加上这个前缀。
• AddSpaStaticFiles.RequestPath：告诉静态文件中间件，当收到/Product/Site/xxx的请求时，去ClientApp/build/xxx找对应的文件。
• Spa.Options.BasePath & DefaultPage：确保SPA的入口页面路径正确，当用户访问http://localhost:5005/Product/Site时，中间件能正确定位到ClientApp/build/index.html，同时SPA内部的路由也会基于这个基础路径工作。

最后再确认一下HttpSys的UrlPrefixes配置是正确的：

webBuilder.UseHttpSys(options => {
    options.AllowSynchronousIO = false;
    options.Authentication.Schemes = AuthenticationSchemes.None;
    options.Authentication.AllowAnonymous = true;
    options.MaxConnections = null;
    options.MaxRequestBodySize = 30000000;
    options.UrlPrefixes.Add("http://localhost:5005/Product/Site");
});

这样调整后，你的SPA应该就能正常加载默认页面了，静态资源和路由也会正确匹配/Product/Site前缀。

内容的提问来源于stack exchange，提问作者Steven T. Cramer