ServiceStack异常处理：传递第三方返回429状态码的技术问题

在ServiceStack里处理自定义的TooManyRequests异常并返回429状态码其实很直接，下面是几种推荐的实现方式，适配你提到的复用方法、多场景调用的需求：

ServiceStack提供了IHasStatusCode接口，只要你的自定义异常实现这个接口，框架会自动识别并返回对应的HTTP状态码，不需要额外的全局配置。

首先定义你的异常类：

public class TooManyRequestsException : Exception, IHasStatusCode
{
    // 直接返回429状态码
    public int StatusCode => (int)System.Net.HttpStatusCode.TooManyRequests;
    
    // 可选：添加RetryAfter属性，支持返回重试间隔
    public int? RetryAfter { get; set; }

    public TooManyRequestsException(string message, int? retryAfter = null) 
        : base(message)
    {
        RetryAfter = retryAfter;
    }
}

当你在调用第三方的方法中检测到429响应时，直接抛出这个异常：

var response = await client.GetAsync(thirdPartyUrl);
if (response.StatusCode == HttpStatusCode.TooManyRequests)
{
    // 可以从第三方响应中提取Retry-After头，传递给异常
    var retryAfter = response.Headers.RetryAfter?.Delta?.Seconds;
    throw new TooManyRequestsException("请求过于频繁，请稍后重试", retryAfter);
}

这样不管是直接通过GET请求触发，还是在其他HTTP请求内部调用这个方法，ServiceStack都会自动捕获异常，返回429状态码，同时把异常消息作为响应内容。

如果你希望返回的错误响应包含更规范的ServiceStack格式（比如带ResponseStatus字段），可以让异常实现IResponseStatusConvertible接口：

public class TooManyRequestsException : Exception, IHasStatusCode, IResponseStatusConvertible
{
    public int StatusCode => (int)HttpStatusCode.TooManyRequests;
    public int? RetryAfter { get; set; }

    public TooManyRequestsException(string message, int? retryAfter = null) 
        : base(message)
    {
        RetryAfter = retryAfter;
    }

    public ResponseStatus ToResponseStatus()
    {
        return new ResponseStatus
        {
            ErrorCode = nameof(TooManyRequestsException),
            Message = Message,
            StatusCode = StatusCode,
            // 可选：添加额外字段
            Meta = RetryAfter.HasValue ? new Dictionary<string, string> { { "RetryAfter", RetryAfter.Value.ToString() } } : null
        };
    }
}

此时返回的JSON响应会是这样的格式：

{
  "ResponseStatus": {
    "ErrorCode": "TooManyRequestsException",
    "Message": "请求过于频繁，请稍后重试",
    "StatusCode": 429,
    "Meta": {
      "RetryAfter": "10"
    }
  }
}

如果需要更灵活的处理逻辑（比如统一添加Retry-After头、日志记录），可以在AppHost的Configure方法中注册全局异常处理器：

public override void Configure(Container container)
{
    // 注册全局异常处理
    this.GlobalExceptionHandlers.Add((request, response, exception) =>
    {
        if (exception is TooManyRequestsException tooManyEx)
        {
            // 设置状态码
            response.StatusCode = tooManyEx.StatusCode;
            response.StatusDescription = tooManyEx.Message;
            
            // 添加Retry-After头（如果有）
            if (tooManyEx.RetryAfter.HasValue)
            {
                response.AddHeader(System.Net.HttpRequestHeader.RetryAfter.ToString(), tooManyEx.RetryAfter.Value.ToString());
            }
            
            // 结束请求，确保响应正确返回
            response.EndRequest();
        }
    });
}

• 不管是直接调用还是嵌套在其他请求中调用第三方方法，只要抛出自定义异常，ServiceStack的异常处理机制都会捕获并处理，不需要单独为每个服务方法配置。
• 429响应的最佳实践是携带Retry-After头，告诉客户端多久后可以重试，上面的实现已经包含了这个逻辑。

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