如何覆盖ASP.NET Web API无匹配路由的默认404错误消息？

方案1：添加无参Details方法直接返回自定义响应 #

最简单的方式是在SearchController里新增一个不带参数的Details方法，专门处理无参数的请求：

public class SearchController : ControllerBase
{
    // 原有带参方法
    [HttpGet("api/details")]
    public IActionResult Details(int id, int clientId)
    {
        // 你的业务逻辑
        return Ok();
    }

    // 无参请求处理方法
    [HttpGet("api/details")]
    public IActionResult Details()
    {
        return NotFound("未找到匹配路由");
    }
}

ASP.NET会自动根据请求参数匹配对应方法，这个方式精准针对api/details路径的无参请求。

方案2：用中间件全局拦截指定路径的404 #

如果需要统一处理这类场景，可添加自定义中间件拦截404并替换响应内容：
在.NET 6+的Program.cs中加入以下代码（放在MapControllers之前）：

app.Use(async (context, next) =>
{
    await next();
    // 检查是否是目标路径的404
    if (context.Response.StatusCode == StatusCodes.Status404NotFound && 
        context.Request.Path.Equals("/api/details", StringComparison.OrdinalIgnoreCase))
    {
        context.Response.ContentType = "application/json";
        await context.Response.WriteAsync("{\"message\":\"未找到匹配路由\"}");
    }
});

app.MapControllers();

方案3：用自定义过滤器针对性处理控制器请求 #

创建一个过滤器，专门检查SearchController的Details方法参数缺失情况：

public class CustomNotFoundFilter : IActionFilter
{
    public void OnActionExecuting(ActionExecutingContext context)
    {
        // 定位目标控制器和方法
        if (context.Controller is SearchController && 
            context.ActionDescriptor.ActionName.Equals("Details", StringComparison.OrdinalIgnoreCase) &&
            context.HttpContext.Request.Path.Equals("/api/details", StringComparison.OrdinalIgnoreCase))
        {
            // 检查必要参数是否缺失
            if (!context.ActionArguments.ContainsKey("id") || !context.ActionArguments.ContainsKey("clientId"))
            {
                context.Result = new NotFoundObjectResult("未找到匹配路由");
            }
        }
    }

    public void OnActionExecuted(ActionExecutedContext context) { }
}

然后在控制器上注册过滤器：

[ServiceFilter(typeof(CustomNotFoundFilter))]
public class SearchController : ControllerBase
{
    // 控制器方法
}

也可以在Program.cs中全局注册，作用于所有控制器：

builder.Services.AddControllers(options =>
{
    options.Filters.Add<CustomNotFoundFilter>();
});

方案4：修改路由模板强制参数必填 #

给原方法的路由模板添加参数约束，让无参请求直接触发404，再全局替换响应：

[HttpGet("api/details/{id:int}/{clientId:int}")]
public IActionResult Details(int id, int clientId)
{
    // 原有业务逻辑
    return Ok();
}

然后在Program.cs中配置全局404响应：

app.UseStatusCodePages(async context =>
{
    if (context.HttpContext.Response.StatusCode == 404)
    {
        context.HttpContext.Response.ContentType = "application/json";
        await context.HttpContext.Response.WriteAsync("{\"message\":\"未找到匹配路由\"}");
    }
});

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