OwinMiddleware未捕获控制器异常问题排查求助

这个问题我之前也碰到过，主要是Web API的异常处理机制和Owin管道的执行顺序在搞鬼，咱们一步步来拆解原因和解决办法：

核心原因 #

1. Web API内置异常处理先拦截了异常
   ASP.NET Web API有自己独立的异常处理管道（比如全局异常过滤器、默认错误处理逻辑），当控制器里抛出异常时，Web API会优先捕获这些异常，把它们转换成标准的HTTP错误响应返回给客户端，根本不会让异常冒泡到Owin中间件的try/catch块里。

2. Owin中间件顺序不对 + 缺少关键配置
   你的自定义中间件虽然加了，但当前配置里没有把Web API接入Owin管道（也就是缺少app.UseWebApi(config)这一步），而且就算加了，如果中间件顺序不对（比如Web API中间件在自定义异常中间件之前），也会导致异常先被Web API处理掉。

解决方案 #

1. 调整Owin中间件顺序，补全Web API集成 #

首先要把自定义异常中间件放在Web API中间件之前，同时确保添加app.UseWebApi(config)来把Web API接入Owin管道。修改后的配置代码如下：

public void Configuration(IAppBuilder app) { 
    // Enables use of spatial data types 
    SqlServerTypes.Utilities.LoadNativeAssemblies(HostingEnvironment.MapPath("~/bin")); 
    HttpConfiguration config = new HttpConfiguration(); 
    IContainer container = AutoFacConfig.Register(config, app); 

    app.UseApplicationInsights(); 
    app.UseNLog(); 
    // 先注册自定义异常中间件，确保它能捕获后续管道的异常
    app.Use<UnhandledExceptionMiddleware>(); 
    // 关键：将Web API接入Owin管道，这一步不能少！
    app.UseWebApi(config); 
}

2. （可选）改进中间件，处理响应错误 #

你的当前中间件只记录日志但不返回错误响应，用户会收到空白或者无效响应，建议补充响应逻辑：

public class UnhandledExceptionMiddleware : OwinMiddleware { 
    private static readonly Logger logger = LogManager.GetCurrentClassLogger(); 
    public UnhandledExceptionMiddleware(OwinMiddleware next) : base(next) { } 
    public override async Task Invoke(IOwinContext context) { 
        try { 
            await Next.Invoke(context); 
            // 额外处理已经返回的错误状态码（比如Web API返回的400/500）
            if (context.Response.StatusCode >= 400)
            {
                logger.Warn($"请求失败，状态码：{context.Response.StatusCode}");
            }
        } catch (Exception ex) { 
            logger.Fatal(ex, ex.Message); 
            // 构造标准JSON错误响应给客户端
            context.Response.StatusCode = (int)HttpStatusCode.InternalServerError;
            context.Response.ContentType = "application/json";
            var errorInfo = new { 
                Message = "服务器发生未处理异常", 
                Detail = ex.Message 
            };
            await context.Response.WriteAsync(Newtonsoft.Json.JsonConvert.SerializeObject(errorInfo));
        } 
    } 
}

3. 补充Web API全局异常过滤器（双保险） #

如果主要目标是捕获控制器内的异常，推荐同时使用Web API的全局异常过滤器，它更贴合Web API的执行管道，能精准捕获控制器层面的异常：

public class ApiGlobalExceptionFilter : ExceptionFilterAttribute
{
    private static readonly Logger logger = LogManager.GetCurrentClassLogger();
    public override void OnException(HttpActionExecutedContext context)
    {
        logger.Fatal(context.Exception, "API控制器异常");
        // 返回自定义错误响应
        context.Response = new HttpResponseMessage(HttpStatusCode.InternalServerError)
        {
            Content = new StringContent(Newtonsoft.Json.JsonConvert.SerializeObject(new { 
                Message = "API请求出错",
                Error = context.Exception.Message 
            })),
            ReasonPhrase = "Internal Server Error"
        };
    }
}

然后在HttpConfiguration中注册这个过滤器：

// 在config初始化后添加
config.Filters.Add(new ApiGlobalExceptionFilter());

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