ASP.NET Core 6 Web API：ELMAH捕获404但异常过滤器未触发

问题核心 #

访问根URL返回的404属于HTTP状态码错误，并非未处理异常——你配置的ExceptionFilter和UseExceptionHandler只针对代码抛出的异常生效，所以完全不会触发这类路由匹配失败的404。而ELMAH默认会捕获所有非2xx的HTTP状态码，才会频繁发送邮件通知。

解决方案步骤 #

1. 直接给ELMAH加过滤规则 #

最直接的方式是在ELMAH配置里排除根路径的404，让它不记录这类错误：

// 替换原来的app.UseElmah();
app.UseElmah(options =>
{
    options.OnError = context =>
    {
        // 拦截根路径的404，不记录、不发邮件
        if (context.HttpContext.Request.Path == "/" && context.HttpContext.Response.StatusCode == 404)
        {
            return Task.FromResult(false);
        }
        // 其他错误正常处理
        return Task.FromResult(true);
    };
});

2. 自定义中间件提前拦截404 #

如果需要更灵活的控制（比如自定义返回内容），可以在ELMAH之前加一个中间件，提前处理根路径的404，避免ELMAH捕获：

// 必须放在app.UseElmah()之前
app.Use(async (context, next) =>
{
    await next();

    // 检查是否是根路径的404
    if (context.Response.StatusCode == 404 && context.Request.Path == "/")
    {
        // 自定义返回内容
        context.Response.ContentType = "application/json";
        await context.Response.WriteAsync(JsonConvert.SerializeObject(new 
        {
            StatusCode = 404,
            Message = "API根节点未开放"
        }));
        
        // 清除异常特征，阻止ELMAH处理该请求
        context.Features.Set<IExceptionHandlerFeature>(null);
    }
});

app.UseElmah();

3. 明确ExceptionFilter的适用范围 #

你的ExceptionFilter只负责处理控制器动作中抛出的异常（比如业务逻辑异常），对路由不匹配的404完全无效。如果需要确保过滤器能处理控制器内的异常，检查实现是否正确：

public class ExceptionFilter : IExceptionFilter
{
    public void OnException(ExceptionContext context)
    {
        if (context.Exception is ApiErrorException apiEx)
        {
            context.Result = new JsonResult(new BaseReturnDataObject
            {
                ErrorType = apiEx.GetType().Name,
                ErrorMsg = apiEx.Message
            })
            {
                StatusCode = StatusCodes.Status400BadRequest
            };
            context.ExceptionHandled = true;
        }
    }
}

关键注意事项 #

• ELMAH中间件必须放在所有业务中间件之后，但自定义拦截中间件要放在ELMAH之前。
• ASP.NET Core的404分两种：路由匹配失败的无异常404、代码主动抛出NotFoundException的有异常404，你的原有逻辑只处理后者。

内容的提问来源于stack exchange，提问作者Eric Brown - Cal