如何通过Routing Controller处理静态文件？弃用app.UseStaticFiles()优化URL

1. 修改路由配置 #

要让所有请求都指向PageController的Index方法，需要使用通配符路由（catch-all route），替换你原来的路由配置：

app.MapControllerRoute(
    name: "static-files",
    pattern: "{*fileName}",
    defaults: new { controller = "Page", action = "Index", fileName = "index" }
);

• {*fileName}：匹配URL中所有路径部分（包括带后缀的文件路径和无后缀的路径）
• 默认fileName = "index"：处理根路径https://localhost:7177/时，自动传入index作为参数

2. 实现PageController逻辑 #

在PageController中，需要处理无后缀URL（比如/user对应user.html）、读取文件并返回正确的内容类型：

using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.Mvc;
using System.IO;

public class PageController : Controller
{
    private readonly IWebHostEnvironment _webHostEnv;

    // 注入IWebHostEnvironment获取静态文件目录路径
    public PageController(IWebHostEnvironment webHostEnv)
    {
        _webHostEnv = webHostEnv;
    }

    public IActionResult Index(string fileName)
    {
        // 处理无后缀URL：自动添加.html后缀
        var fileExt = Path.GetExtension(fileName);
        if (string.IsNullOrEmpty(fileExt))
        {
            fileName += ".html";
        }

        // 拼接文件物理路径（假设静态文件存放在wwwroot目录下）
        var filePath = Path.Combine(_webHostEnv.WebRootPath, fileName);

        // 文件不存在时返回404
        if (!System.IO.File.Exists(filePath))
        {
            return NotFound();
        }

        // 根据文件后缀设置正确的Content-Type
        var contentType = fileExt.ToLower() switch
        {
            ".html" => "text/html",
            ".css" => "text/css",
            ".js" => "application/javascript",
            ".png" => "image/png",
            ".jpg" => "image/jpeg",
            _ => "application/octet-stream"
        };

        // 返回文件内容
        return PhysicalFile(filePath, contentType);
    }
}

3. 关键说明 #

• URL美观需求：访问https://localhost:7177/user会自动映射到user.html，无需在URL中添加.html后缀
• 无需静态文件中间件：所有静态文件请求都通过控制器处理，不需要启用app.UseStaticFiles()
• 文件存储位置：确保你的HTML、CSS、JS等文件都放在项目的wwwroot目录下（如果需要自定义目录，可修改Path.Combine中的路径）
• 路由优先级：这个通配符路由要放在其他路由配置的前面，避免被更具体的路由抢先匹配

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