属性路由(Attribute Routing)下捕获未匹配请求的实现方案咨询

嘿，这个场景我之前刚好处理过，咱们来聊聊两种可行的方案，帮你搞定未匹配请求的捕获：

方案一：用约定路由做全局兜底（推荐） #

这是最直接省心的方式，因为约定路由可以放在所有属性路由之后，作为最后一道兜底逻辑。以.NET 6+的Program.cs为例：

首先在配置完属性路由映射后，添加兜底路由：

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();

var app = builder.Build();

// 先映射所有带属性路由的控制器
app.MapControllers();

// 配置兜底路由，捕获所有未被匹配的请求，指向专门的处理动作
app.MapFallbackToController("HandleUnmatchedRequests", "Fallback");

app.Run();

然后创建对应的兜底控制器：

public class FallbackController : Controller
{
    // 指定接受GET/POST/PUT三种请求方法
    [AcceptVerbs("GET", "POST", "PUT")]
    public IActionResult HandleUnmatchedRequests(string? catchall)
    {
        // 这里根据你的需求处理：比如重定向到首页
        return RedirectToAction("Get", "Home");
        // 或者返回错误信息
        // return BadRequest($"无效的请求路径：{catchall}");
    }
}

这种方式的好处是不用操心路由优先级，MapFallbackToController本身就会在所有其他路由匹配失败后才触发。

方案二：用属性路由实现兜底捕获 #

当然也可以用属性路由来实现，核心是用通配符路由模板{*catchall}来匹配任意路径，同时确保这个兜底控制器的路由优先级最低（也就是让它在所有具体路由之后被匹配）。

创建一个专门的兜底控制器：

// 通配符路由{*catchall}会匹配任意未被其他路由命中的路径
[Route("{*catchall}")]
public class FallbackController : Controller
{
    [HttpGet]
    public IActionResult HandleGetRequests(string catchall)
    {
        return RedirectToAction("Get", "Home");
    }

    [HttpPost]
    public IActionResult HandlePostRequests(string catchall)
    {
        return BadRequest("未找到匹配的POST接口");
    }

    [HttpPut]
    public IActionResult HandlePutRequests(string catchall)
    {
        return BadRequest("未找到匹配的PUT接口");
    }
}

如果想统一处理三种方法，也可以用[AcceptVerbs]合并：

[Route("{*catchall}")]
public class FallbackController : Controller
{
    [AcceptVerbs("GET", "POST", "PUT")]
    public IActionResult HandleAllUnmatched(string catchall)
    {
        // 根据请求方法区分处理逻辑
        switch (HttpContext.Request.Method)
        {
            case HttpMethods.Get:
                return RedirectToAction("Get", "Home");
            case HttpMethods.Post:
            case HttpMethods.Put:
                return BadRequest($"未找到匹配的{HttpContext.Request.Method}请求路径");
            default:
                return NotFound();
        }
    }
}

关键注意点 #

不管用哪种方案，都要记住：

• ASP.NET Core的路由匹配是优先匹配更具体的路由，所以兜底路由必须是最后被处理的。用约定路由的MapFallbackToController不用手动管这个，但用属性路由的话，要确保兜底控制器的路由模板是最宽泛的（{*catchall}就是最宽泛的），且不要在其他具体路由之前注册。
• 如果需要捕获更多HTTP方法，直接在AcceptVerbs里添加即可，比如"DELETE"、"PATCH"等。

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