如何在ASP.NET MVC中允许URL包含所有文件扩展名？

嘿，我来帮你搞定这个问题！要让你的ASP.NET MVC应用支持/Download/{FileName}.extension这种带任意文件扩展名的URL，你需要同时调整MVC路由规则和IIS请求处理配置，确保这类请求不会被IIS直接拦截，而是能正确到达你的控制器逻辑。下面是具体的实现步骤：

1. 配置MVC路由，捕获带扩展名的文件名 #

默认情况下，MVC路由可能不会处理带扩展名的URL（因为IIS通常会直接处理这类请求）。你需要添加一条自定义路由，明确捕获包含扩展名的文件名参数。

打开App_Start/RouteConfig.cs，添加一条优先级更高的下载路由：

public class RouteConfig
{
    public static void RegisterRoutes(RouteCollection routes)
    {
        routes.IgnoreRoute("{resource}.axd/{*pathInfo}");

        // 自定义下载路由：捕获包含扩展名的完整文件名
        routes.MapRoute(
            name: "Download",
            url: "Download/{fileNameWithExtension}",
            defaults: new { controller = "Download", action = "Index" }
        );

        // 保留默认路由
        routes.MapRoute(
            name: "Default",
            url: "{controller}/{action}/{id}",
            defaults: new { controller = "Home", action = "Index", id = UrlParameter.Optional }
        );
    }
}

这条路由会把所有/Download/开头的请求，比如/Download/Report.docx、/Download/Image.png，都导向DownloadController的Index方法，并且把完整的文件名（包含扩展名）作为fileNameWithExtension参数传递。

2. 修改Web.config，让IIS将请求交给ASP.NET处理 #

接下来需要配置IIS，让它不要直接处理/Download/路径下的文件请求，而是转交给ASP.NET的请求处理管道。

在Web.config的<system.webServer>/<handlers>节点中添加一个自定义handler：

<system.webServer>
  <handlers>
    <!-- 让所有/Download/开头的GET请求都交给TransferRequestHandler处理 -->
    <add name="DownloadFileHandler" path="Download/*" verb="GET" 
         type="System.Web.Handlers.TransferRequestHandler" 
         preCondition="integratedMode,runtimeVersionv4.0" />
    
    <!-- 保留原有的MVC相关handler配置 -->
    <remove name="ExtensionlessUrlHandler-Integrated-4.0" />
    <remove name="OPTIONSVerbHandler" />
    <remove name="TRACEVerbHandler" />
    <add name="ExtensionlessUrlHandler-Integrated-4.0" path="*." verb="*" type="System.Web.Handlers.TransferRequestHandler" preCondition="integratedMode,runtimeVersionv4.0" />
  </handlers>
</system.webServer>

这个配置的作用是：所有针对/Download/路径的GET请求，都会被TransferRequestHandler接管，然后传递给MVC路由引擎处理，而不是让IIS根据扩展名直接返回文件或报错。

3. 实现下载控制器的逻辑 #

最后创建DownloadController，编写处理下载请求的代码，记得要做安全校验（防止路径遍历攻击）：

public class DownloadController : Controller
{
    public ActionResult Index(string fileNameWithExtension)
    {
        // 安全校验：防止路径遍历攻击（比如传入../../malware.exe）
        if (string.IsNullOrWhiteSpace(fileNameWithExtension) || 
            fileNameWithExtension.Contains("..") || 
            Path.IsPathRooted(fileNameWithExtension))
        {
            return new HttpStatusCodeResult(HttpStatusCode.BadRequest);
        }

        // 假设你的文件存储在App_Data/Downloads目录下，根据实际路径调整
        var filePath = Server.MapPath($"~/App_Data/Downloads/{fileNameWithExtension}");
        
        // 检查文件是否存在
        if (!System.IO.File.Exists(filePath))
        {
            return HttpNotFound();
        }

        // 获取文件的MIME类型
        var contentType = MimeMapping.GetMimeMapping(filePath);
        
        // 返回文件给客户端（第三个参数是浏览器显示的下载文件名）
        return File(filePath, contentType, fileNameWithExtension);
    }
}

额外注意事项 #

• 如果你的应用运行在经典模式（而非集成模式），还需要在<system.web>/<httpHandlers>节点添加对应的handler配置，不过现在大多用集成模式，这一步通常可以忽略。
• 不要随便设置runAllManagedModulesForAllRequests="true"，这会让所有请求都经过ASP.NET管道，严重影响性能，我们上面的handler配置更精准。

这样配置完成后，你的应用就能支持任意扩展名的/Download/{FileName}.extension格式URL了！

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