C# .NET Core Web API调用第三方服务失败时应返回何种HTTP响应？

嘿，你的判断完全正确！当你的API作为网关调用第三方服务，且上游服务返回无效响应（或者根本无法响应）时，返回502 Bad Gateway确实是符合HTTP规范的最佳选择。我来给你分享几种在.NET Core里实现这个需求的具体方式。

一、在单个Action中直接返回502 #

如果只是特定几个接口需要处理这种场景，你可以在Action内部捕获第三方服务调用的异常，然后构造符合规范的响应返回。

代码示例： #

using Microsoft.AspNetCore.Mvc;
using System.Net.Http.Json;

[ApiController]
[Route("api/[controller]")]
public class DataController : ControllerBase
{
    private readonly HttpClient _httpClient;

    // 通过依赖注入注入HttpClient
    public DataController(HttpClient httpClient)
    {
        _httpClient = httpClient;
    }

    [HttpGet("third-party")]
    public async Task<IActionResult> FetchThirdPartyData()
    {
        try
        {
            // 调用第三方服务
            var thirdPartyResponse = await _httpClient.GetAsync("https://third-party-service.com/api/data");
            
            // 如果第三方返回非2xx状态码，抛出HttpRequestException
            thirdPartyResponse.EnsureSuccessStatusCode();

            var data = await thirdPartyResponse.Content.ReadFromJsonAsync<ThirdPartyDataModel>();
            return Ok(data);
        }
        catch (HttpRequestException ex)
        {
            // 构造符合RFC 7807规范的ProblemDetails响应体
            var problemDetails = new ProblemDetails
            {
                Status = StatusCodes.Status502BadGateway,
                Title = "Bad Gateway",
                Detail = $"调用第三方服务时收到无效响应：{ex.Message}",
                // 可选：添加指向HTTP规范的类型链接
                Type = "https://tools.ietf.org/html/rfc7231#section-6.6.3"
            };

            // 返回带有502状态码的ObjectResult
            return new ObjectResult(problemDetails)
            {
                StatusCode = StatusCodes.Status502BadGateway
            };
        }
    }

    // 第三方服务数据模型示例
    private class ThirdPartyDataModel
    {
        public int Id { get; set; }
        public string Content { get; set; }
    }
}

二、全局异常过滤器统一处理 #

如果你的API中有很多接口都需要调用第三方服务，重复写try-catch会很繁琐。这时候可以用全局异常过滤器来统一捕获第三方服务调用的异常，自动返回502响应。

步骤1：创建自定义异常过滤器 #

using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.Filters;

public class ThirdPartyGatewayExceptionFilter : IExceptionFilter
{
    public void OnException(ExceptionContext context)
    {
        // 只处理HttpClient调用抛出的HttpRequestException
        if (context.Exception is HttpRequestException ex)
        {
            // 可以根据实际情况添加更精细的判断，比如上游返回5xx时才返回502
            var problemDetails = new ProblemDetails
            {
                Status = StatusCodes.Status502BadGateway,
                Title = "Bad Gateway",
                Detail = $"第三方服务响应异常：{ex.Message}",
                Type = "https://tools.ietf.org/html/rfc7231#section-6.6.3"
            };

            context.Result = new ObjectResult(problemDetails)
            {
                StatusCode = StatusCodes.Status502BadGateway
            };
            // 标记异常已处理，避免后续中间件再处理
            context.ExceptionHandled = true;
        }
    }
}

步骤2：注册过滤器到全局 #

在Program.cs中注册这个过滤器：

var builder = WebApplication.CreateBuilder(args);

// 添加控制器并注册全局过滤器
builder.Services.AddControllers(options =>
{
    options.Filters.Add<ThirdPartyGatewayExceptionFilter>();
});

// 其他服务注册...

var app = builder.Build();

// 中间件配置...

app.MapControllers();

app.Run();

三、注意事项 #

• 精准判断异常场景：不是所有的HttpRequestException都应该返回502。比如如果是你的API请求参数错误导致第三方返回400 Bad Request，这时候应该返回400给客户端，而不是502。你可以在catch块里通过ex.StatusCode属性做更精细的判断。
• 响应体规范：使用ProblemDetails类返回响应体，符合RFC 7807的错误格式，让客户端更容易解析错误信息。
• 日志记录：在返回502之前，记得记录详细的错误日志（比如第三方服务的URL、异常信息、时间等），方便后续排查问题。

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