.NET 8 gRPC服务限流后客户端未收到正确RpcException问题排查

API 探路者

2026-6-19

修复gRPC限流时客户端收到内部异常的问题

你的问题出在RateLimiter的OnRejected回调是HTTP管道层面的拦截点，直接抛出RpcException会被ASP.NET Core的全局错误处理捕获，转换成通用的内部服务器异常，而非正确的gRPC状态码。

要让客户端正确收到ResourceExhausted状态，需要直接构造符合gRPC规范的HTTP/2响应，而非依赖抛出异常。修改方案如下：

修改后的限流配置代码

services.AddRateLimiter(options =>
{
    options.AddConcurrencyLimiter(policyName: concurrencyPolicyName, options =>
    {
        options.PermitLimit = 1;
        options.QueueProcessingOrder = QueueProcessingOrder.OldestFirst;
        options.QueueLimit = 0;
    });

    options.OnRejected = async (context, token) =>
    {
        var httpContext = context.HttpContext;
        // 设置HTTP 429状态码，对应gRPC的ResourceExhausted
        httpContext.Response.StatusCode = StatusCodes.Status429TooManyRequests;

        // 设置gRPC标准响应头，传递错误状态和信息
        httpContext.Response.Headers["grpc-status"] = "11"; // 11是ResourceExhausted的gRPC状态码值
        httpContext.Response.Headers["grpc-message"] = "The service is currently handling too many requests. Please try again later";

        // 直接结束响应，避免后续管道处理干扰
        await httpContext.Response.CompleteAsync(token);
    };
});

关键说明

gRPC错误传递机制：gRPC基于HTTP/2，错误状态通过grpc-status和grpc-message响应头传递，而非普通HTTP响应体。grpc-status的数值11对应StatusCode.ResourceExhausted。
避免抛出异常：在OnRejected中抛出RpcException会被ASP.NET Core的异常处理中间件捕获，覆盖你期望的gRPC状态，转而返回内部服务器错误。
响应收尾：调用CompleteAsync确保响应正确终止，防止后续管道环节修改响应内容。