Abp.io项目中Sentry自动捕获异常失效问题排查

问题根源 #

Abp.io框架自带全局异常处理机制，它会提前捕获应用层抛出的异常，完成包装或生成友好响应后就终止了异常传递流程。而Sentry.AspNetCore依赖ASP.NET Core的异常中间件捕获未被处理的顶层异常，所以Abp把异常“截胡”后，Sentry就收不到手动抛出的异常了——只有直接调用SentrySdk.CaptureException能绕开这个拦截逻辑。

解决方案 #

方法一：通过Abp异常订阅者上报Sentry（推荐） #

借助Abp的异常订阅扩展，在Abp处理异常的同时同步上报Sentry，不破坏Abp原有异常处理逻辑：

1. 创建异常订阅类，实现IExceptionSubscriber接口：

public class SentryExceptionSubscriber : IExceptionSubscriber, ITransientDependency
{
    public async Task HandleAsync(ExceptionNotificationContext context)
    {
        // 将异常上报至Sentry
        SentrySdk.CaptureException(context.Exception);
        await Task.CompletedTask;
    }
}

2. 该类会被Abp的依赖注入系统自动发现注册，之后所有被Abp捕获的异常都会触发这个订阅逻辑，自动上报到Sentry。

方法二：让异常穿透到ASP.NET Core中间件 #

调整Abp的异常处理配置，允许原始异常继续冒泡到ASP.NET Core的异常中间件，让Sentry能捕获到：

在模块类的ConfigureServices方法中添加配置：

public override void ConfigureServices(ServiceConfigurationContext context)
{
    // 其他配置逻辑...
    
    Configure<AbpExceptionHandlingOptions>(options =>
    {
        // 禁止Abp包装异常，让原始异常继续向上传递
        options.WrapExceptions = false;
        // 可选：是否将异常详情返回给客户端，根据业务需求设置
        options.SendExceptionsDetailsToClients = true;
    });
}

注意：这种方式会改变Abp默认的异常响应格式，可能导致接口直接返回原始异常信息，需根据业务场景评估适用性。

额外验证 #

确认你的Sentry配置无误，比如CreateHostBuilder中的配置示例：

public static IHostBuilder CreateHostBuilder(string[] args) =>
    Host.CreateDefaultBuilder(args)
        .ConfigureWebHostDefaults(webBuilder =>
        {
            webBuilder.UseSentry(options =>
            {
                options.Dsn = "你的Sentry DSN";
                options.Debug = true;
                options.TracesSampleRate = 1.0;
            });
            webBuilder.UseStartup<Startup>();
        });

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