.NET 8.0中CatchAll Url重定向至首页失效问题

我在.NET 8.0中配置了未匹配URL重定向到首页的规则，但功能无法正常工作，仅返回无意义错误。相同配置在带startup.cs的旧版.NET中可以正常运行。

配置代码：

app.MapControllerRoute(
            name: "NotFound",
            pattern: "{**catchall}",
            defaults: new { controller = "Home", action = "Index"});

HomeController代码：

public class HomeController : Controller
{
    private readonly ILogger<HomeController> _logger;

    public HomeController(ILogger<HomeController> logger)
    {
        _logger = logger;
    }

    public IActionResult Index()
    {
        return View();
    }

    public IActionResult Privacy()
    {
        return View();
    }

    [ResponseCache(Duration = 0, Location = ResponseCacheLocation.None, NoStore = true)]
    public IActionResult Error()
    {
        return View(new ErrorViewModel { RequestId = Activity.Current?.Id ?? HttpContext.TraceIdentifier });
    }
}

1. 调整路由注册顺序 #

.NET 8.0的最小API模型中，路由匹配顺序优先级极高。必须将catch-all路由放在所有其他控制器路由之后，否则会提前拦截所有请求，导致正常路由失效。

正确顺序示例：

// 先注册默认路由
app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

// 最后注册catch-all路由
app.MapControllerRoute(
    name: "NotFound",
    pattern: "{**catchall}",
    defaults: new { controller = "Home", action = "Index" });

2. 确认控制器路由服务已启用 #

确保Program.cs中完整配置了控制器和视图服务，示例：

var builder = WebApplication.CreateBuilder(args);

// 注册控制器与视图服务
builder.Services.AddControllersWithViews();

var app = builder.Build();

// 中间件配置
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Home/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();
app.UseAuthorization();

// 先注册具体路由
app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

// 末尾注册全局catch-all路由
app.MapControllerRoute(
    name: "NotFound",
    pattern: "{**catchall}",
    defaults: new { controller = "Home", action = "Index" });

app.Run();

3. 按需选择重定向或直接返回视图 #

如果需要地址栏URL同步变更（真正重定向），可改用MapFallback：

app.MapFallback(() => Results.Redirect("/Home/Index"));

若无需变更URL，直接返回首页视图，保持原路由配置即可，但需确保路由顺序正确。

4. 排除静态文件干扰 #

ASP.NET Core会优先返回存在的静态文件（如JS、CSS、图片），这类请求不会进入catch-all路由。若需对静态文件路径也做重定向，需调整静态文件中间件配置，或确认请求路径无对应静态资源。

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