OWIN中间件全局异常处理无法捕获控制器层抛出的异常

这个问题我之前也踩过坑，核心原因是ASP.NET Web API自带的异常处理机制会先拦截异常，再加上OWIN中间件的注册顺序可能不对，导致你的catch代码块根本没机会触发。下面一步步给你解决：

1. 先确认中间件的注册顺序 #

OWIN中间件是按注册顺序依次执行的，你的全局异常中间件必须放在Web API中间件之前注册，不然Web API先处理请求并拦截异常，中间件就抓不到了。

比如在Startup.cs里要这么写：

public void Configuration(IAppBuilder app)
{
    // 第一步：先注册全局异常中间件
    app.Use<GlobalExceptionMiddleware>();

    // 第二步：再注册Web API相关配置
    var config = new HttpConfiguration();
    config.MapHttpAttributeRoutes(); // 配置属性路由
    app.UseWebApi(config);
}

2. 禁用Web API的自动异常处理 #

Web API默认会把未处理的异常转换成HttpResponseMessage返回，不会把异常抛到OWIN中间件层。我们需要让Web API把异常“透传”给OWIN中间件：

方法一：替换默认的ExceptionHandler #

写一个自定义的异常处理器，直接把异常重新抛出：

public class PassThroughExceptionHandler : IExceptionHandler
{
    public Task HandleAsync(ExceptionHandlerContext context, CancellationToken cancellationToken)
    {
        // 不处理异常，直接抛给上层的OWIN中间件
        throw context.Exception;
    }
}

然后在Web API配置里替换默认的处理器：

config.Services.Replace(typeof(IExceptionHandler), new PassThroughExceptionHandler());

方法二：移除Web API的异常过滤器 #

如果不需要Web API自带的异常过滤，直接移除：

// 移除默认的异常过滤器
config.Filters.Remove(config.Filters.OfType<IExceptionFilter>().FirstOrDefault());
// 同时设置允许返回错误详情（可选）
config.IncludeErrorDetailPolicy = IncludeErrorDetailPolicy.Always;

3. 确保控制器的异常未被内部捕获 #

检查你的控制器代码，有没有自己用try/catch把异常吞掉？如果控制器里已经捕获了异常，OWIN中间件肯定抓不到，要确保异常是未被处理的状态抛出来的。

比如控制器代码要这样：

public class MyController : ApiController
{
    public async Task<IHttpActionResult> Get()
    {
        // 直接抛出未处理的异常
        throw new InvalidOperationException("控制器里出问题啦！");
    }
}

完整的可运行示例 #

GlobalExceptionMiddleware.cs #

public class GlobalExceptionMiddleware : OwinMiddleware
{
    public GlobalExceptionMiddleware(OwinMiddleware next) : base(next) { }

    public override async Task Invoke(IOwinContext context)
    {
        try
        {
            await Next.Invoke(context);
        }
        catch (Exception ex)
        {
            // 现在这里就能抓到控制器抛出的异常了
            context.Response.StatusCode = (int)HttpStatusCode.InternalServerError;
            context.Response.ContentType = "application/json";
            var errorInfo = new 
            { 
                Message = "服务器发生未处理异常", 
                ErrorDetail = ex.Message 
            };
            await context.Response.WriteAsync(Newtonsoft.Json.JsonConvert.SerializeObject(errorInfo));
        }
    }
}

Startup.cs #

public class Startup
{
    public void Configuration(IAppBuilder app)
    {
        app.Use<GlobalExceptionMiddleware>();

        var config = new HttpConfiguration();
        config.MapHttpAttributeRoutes();
        
        // 配置异常透传
        config.Services.Replace(typeof(IExceptionHandler), new PassThroughExceptionHandler());
        config.Filters.Remove(config.Filters.OfType<IExceptionFilter>().FirstOrDefault());

        app.UseWebApi(config);
    }
}

public class PassThroughExceptionHandler : IExceptionHandler
{
    public Task HandleAsync(ExceptionHandlerContext context, CancellationToken cancellationToken)
    {
        throw context.Exception;
    }
}

这样调整后，你的OWIN中间件就能正常捕获控制器抛出的异常了！

内容的提问来源于stack exchange，提问作者Jaczura Zoltán