Asp.Net Core中MapFallbackToFile使用方法及404问题解析

问题描述 #

我可以通过字符串配置回退路由，代码如下：

app.MapFallback(() => "some text");

但替换为以下代码时：

app.MapFallbackToFile("text.txt"); // 相对路径无效
app.MapFallbackToFile("c:\\folder\\text.txt"); // 绝对路径也无效

会收到HTTP 404错误，请问MapFallbackToFile的工作机制是什么？

工作机制解析 #

MapFallbackToFile是ASP.NET Core里专门处理回退静态文件请求的路由扩展方法，核心逻辑和注意点如下：

• 触发时机：它是路由管道的最后一环，只有当所有常规路由（控制器路由、自定义端点路由等）都匹配失败时才会触发，和MapFallback的触发逻辑一致，但前者只能返回静态文件，后者可以自定义任意响应内容。
• 文件查找规则：
  • 相对路径：默认基于项目的Web根目录（也就是wwwroot文件夹）查找文件，不是项目根目录或程序执行目录。如果你的文件不在wwwroot里，用相对路径必然找不到。
  • 绝对路径：出于安全考虑，默认静态文件服务只允许访问wwwroot内的文件，直接传入绝对路径会被拦截，这就是你用绝对路径返回404的原因。
• 依赖静态文件中间件：必须先在管道中注册app.UseStaticFiles()，否则MapFallbackToFile无法读取并返回文件——它本质是依托静态文件服务来完成文件读取和响应的。

解决你的404问题 #

要让代码生效，可按以下两种方式调整：

1. 使用Web根目录内的文件：
   把text.txt放到项目的wwwroot文件夹下，然后确保先注册静态文件中间件：

   app.UseStaticFiles();
   app.MapFallbackToFile("text.txt");
   

2. 访问Web根目录外的文件：
   先配置静态文件服务允许访问指定外部目录，再对应调整回退路由的路径：

   // 配置允许访问c:\folder目录下的文件，映射请求路径为/external
   app.UseStaticFiles(new StaticFileOptions
   {
       FileProvider = new PhysicalFileProvider(@"c:\folder"),
       RequestPath = "/external"
   });
   // 回退路由要对应配置的请求路径+文件名
   app.MapFallbackToFile("/external/text.txt");
   

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