MVC 5中配置访问/home/somefile.txt出现404错误，如何解决？

问题背景 #

我尝试在MVC 5站点中通过www.mysite.com/home/somefile.txt路径访问一个TXT文件，但一直返回404错误。最开始已经在web.config中添加了处理程序，后续又创建了路由、修改配置并编写了控制器，可访问本地地址http://localhost:10021/home/riot.txt还是报404，最后发现是路由模式错误，修正后问题终于解决。

完整排查与解决步骤 #

• 第一步：确认文件存放位置
  先确保你的somefile.txt（或riot.txt）放在了合适的位置，比如项目根目录、App_Data文件夹下，方便后续控制器读取。

• 第二步：配置web.config的文件处理程序
  要让ASP.NET MVC接管TXT文件的请求，需要在web.config的<system.webServer>节点下添加对应处理规则，确保请求能被ASP.NET处理：

  <handlers>
    <add name="TxtFileHandler" path="*.txt" verb="*" type="System.Web.Handlers.TransferRequestHandler" preCondition="integratedMode,runtimeVersionv4.0" />
  </handlers>
  

• 第三步：配置匹配请求路径的路由
  这是最容易踩坑的环节！必须在RouteConfig.cs中添加完全匹配home/{filename}.txt格式的路由规则，否则请求无法被正确路由到控制器：

  routes.MapRoute(
      name: "TxtFileRoute",
      url: "home/{filename}.txt",
      defaults: new { controller = "Home", action = "GetTxtFile", filename = UrlParameter.Optional }
  );
  

  划重点：路由的url部分必须和你实际的请求路径完全对应，我之前就是因为这里的模式写错，导致home/riot.txt请求无法匹配到路由规则。

• 第四步：编写控制器动作方法
  在Home控制器中添加读取并返回TXT文件内容的动作：

  public ActionResult GetTxtFile(string filename)
  {
      // 可根据实际存储路径调整，示例读取App_Data下的文件
      string filePath = Server.MapPath($"~/App_Data/{filename}.txt");
      if (!System.IO.File.Exists(filePath))
      {
          return HttpNotFound();
      }
      string fileContent = System.IO.File.ReadAllText(filePath);
      return Content(fileContent, "text/plain");
  }
  

最终解决核心 #

问题根源就是路由模式与请求路径不匹配，修正路由的url规则为对应home/riot.txt的格式后，请求就能正确匹配到控制器动作，成功返回TXT文件内容。

内容的提问来源于stack exchange，提问作者Renato Ramos Nascimento