ASP.NET Core结合YARP：如何基于子域名配置MapFallbackToFile()？

你可以通过**分支管道（MapWhen）**结合条件判断，实现不同子域名返回对应SPA文件的需求，具体实现如下：

1. 替换原有单一Fallback配置 #

移除原有的app.MapFallbackToFile("index.html");，改用MapWhen根据主机名创建分支管道，分别配置不同的Fallback规则：

// 保留YARP网关映射
app.MapReverseProxy();

// 处理admin子域名请求：返回wwwroot/admin/index.html
app.MapWhen(context => 
    context.Request.Host.Host.StartsWith("admin.", StringComparison.OrdinalIgnoreCase), 
    adminApp =>
{
    adminApp.MapFallbackToFile("admin/index.html");
});

// 处理其他域名请求：返回wwwroot/index.html
app.MapFallbackToFile("index.html");

2. 静态文件目录迁移适配（可选） #

如果主SPA目录需要迁移到wwwroot以外的位置（比如独立的main-spa目录），或者admin SPA不在wwwroot/admin下，需调整静态文件中间件配置：

示例：双SPA目录独立配置 #

假设主SPA文件放在项目根目录的main-spa，admin SPA放在admin-spa，配置代码如下：

using Microsoft.Extensions.FileProviders;

// 配置主SPA静态文件访问
app.UseStaticFiles(new StaticFileOptions
{
    FileProvider = new PhysicalFileProvider(Path.Combine(env.ContentRootPath, "main-spa")),
    RequestPath = "" // 根路径对应主SPA资源
});

// 配置admin SPA静态文件访问
app.UseStaticFiles(new StaticFileOptions
{
    FileProvider = new PhysicalFileProvider(Path.Combine(env.ContentRootPath, "admin-spa")),
    RequestPath = "/admin" // admin子域名的静态资源请求指向此目录
});

// 配置YARP和Fallback规则
app.MapReverseProxy();

app.MapWhen(context => 
    context.Request.Host.Host.StartsWith("admin.", StringComparison.OrdinalIgnoreCase), 
    adminApp =>
{
    adminApp.MapFallbackToFile("/admin/index.html");
});

app.MapFallbackToFile("/index.html");

3. 关键细节说明 #

• 主机名判断使用StringComparison.OrdinalIgnoreCase，确保大小写不敏感（如Admin.xxx.com也能匹配）。
• MapFallbackToFile仅在路由无法匹配时触发，符合SPA前端路由的需求，不会影响正常静态资源（CSS/JS等）的访问。
• 静态文件中间件会优先处理存在的资源，Fallback逻辑作为兜底，保证SPA路由跳转正常。

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