如何自定义ASP.NET Core的Grpc.Core.RpcException以实现Sentry精准错误追踪

当gRPC服务器将所有异常包装为Grpc.Core.RpcException返回时，Sentry会默认根据外层异常类型分组，导致所有错误归为同一问题。可以通过以下几种方式拆分归类：

方法1：自定义Sentry指纹（推荐） #

利用Sentry的BeforeSend钩子，提取RpcException内部的原始异常，用原始异常的特征生成自定义指纹，让Sentry按原始异常分组。

在Program.cs中配置Sentry：

builder.WebHost.UseSentry(options =>
{
    options.BeforeSend = sentryEvent =>
    {
        // 展开异常链，获取最内层的原始异常
        var originalException = sentryEvent.Exception?.Flatten().InnerExceptions.LastOrDefault();
        if (originalException != null)
        {
            // 用原始异常的类型、消息和栈顶信息生成指纹
            sentryEvent.Fingerprint = new[]
            {
                originalException.GetType().FullName,
                originalException.Message,
                originalException.StackTrace?.Split('\n').FirstOrDefault()?.Trim()
            };
        }
        return sentryEvent;
    };
});

说明：Flatten()方法会展开嵌套的异常链，确保拿到触发错误的原始异常；指纹数组中的元素可以根据需求调整，比如只保留类型和消息，或者加上特定栈帧，避免同类异常不同场景被错误合并。

方法2：通过gRPC拦截器传递原始异常标识 #

创建全局gRPC异常拦截器，在包装RpcException时，将原始异常类型存入响应元数据，再让Sentry读取元数据生成指纹。

步骤1：实现gRPC异常拦截器 #

public class GrpcExceptionInterceptor : Interceptor
{
    public override async Task<TResponse> UnaryServerHandler<TRequest, TResponse>(
        TRequest request,
        ServerCallContext context,
        UnaryServerMethod<TRequest, TResponse> continuation)
    {
        try
        {
            return await continuation(request, context);
        }
        catch (Exception ex)
        {
            // 给不同类型的原始异常分配对应的gRPC状态码（可选）
            var statusCode = ex switch
            {
                ArgumentException => StatusCode.InvalidArgument,
                KeyNotFoundException => StatusCode.NotFound,
                _ => StatusCode.Internal
            };

            // 将原始异常类型写入响应元数据
            context.ResponseTrailers.Add("OriginalExceptionType", ex.GetType().FullName);

            // 保留原始异常作为内部异常抛出
            throw new RpcException(new Status(statusCode, ex.Message), ex);
        }
    }

    // 如需支持流式调用，重写对应的StreamingServerHandler方法即可
}

步骤2：注册拦截器 #

builder.Services.AddGrpc(options =>
{
    options.Interceptors.Add<GrpcExceptionInterceptor>();
});

步骤3：配置Sentry读取元数据生成指纹 #

builder.WebHost.UseSentry(options =>
{
    options.BeforeSend = sentryEvent =>
    {
        // 从gRPC上下文的响应元数据中提取原始异常类型
        if (sentryEvent.Contexts.TryGetValue("grpc", out var grpcContext) &&
            grpcContext is Dictionary<string, object> grpcData &&
            grpcData.TryGetValue("response_trailers", out var trailersObj) &&
            trailersObj is Dictionary<string, string> trailers &&
            trailers.TryGetValue("OriginalExceptionType", out var originalType))
        {
            sentryEvent.Fingerprint = new[] { originalType, sentryEvent.Message };
        }
        return sentryEvent;
    };
});

方法3：Sentry后台自定义分组规则 #

无需修改代码，直接在Sentry项目的【Settings】→【Issue Grouping】中创建自定义规则：

• 规则条件：Exception Type等于Grpc.Core.RpcException
• 分组依据：使用Inner Exception Type或Inner Exception Message作为分组键

说明：这种方式依赖Sentry后台配置，灵活性不如代码实现，但适合快速调试场景。

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