.NET 6中直接调用与通过WebApi返回HttpResponseMessage不一致问题

核心原因 #

在ASP.NET Core（含.NET 6）中，直接返回HttpResponseMessage时，框架不会将其视为需要转发的原始HTTP响应，而是把它当作普通.NET对象进行JSON序列化。这就造成了两个现象：

• 自定义API本身执行逻辑无异常，因此返回200状态码
• 外部API的404响应被拆解为HttpResponseMessage的属性（如StatusCode、Content、Headers等），序列化后作为JSON返回，而非直接转发原始的404响应

正确实现方式 #

要返回外部API的原始响应，需要手动将外部响应的状态码、响应头和内容复制到当前请求的响应中，以下是两种推荐实现：

方式1：通过IActionResult返回 #

[HttpGet("GetDocument")]
public async Task<IActionResult> GetDocument()
{
    using var client = new HttpClient();
    var request = new HttpRequestMessage
    {
        Method = HttpMethod.Get,
        RequestUri = new Uri(url),
        Headers =
        {
            { "Authorization", "Bearer " + _bearer },
        }
    };

    using var response = await client.SendAsync(request);
    
    // 同步外部响应的状态码
    Response.StatusCode = (int)response.StatusCode;
    
    // 复制外部响应的头部（可根据需求筛选不需要的头部）
    foreach (var header in response.Headers)
    {
        Response.Headers.TryAdd(header.Key, header.Value.ToArray());
    }
    foreach (var header in response.Content.Headers)
    {
        Response.Headers.TryAdd(header.Key, header.Value.ToArray());
    }
    
    // 返回外部响应的原始内容
    var contentBytes = await response.Content.ReadAsByteArrayAsync();
    return File(contentBytes, response.Content.Headers.ContentType?.ToString() ?? "application/json");
}

方式2：直接操作HttpContext.Response #

[HttpGet("GetDocument")]
public async Task GetDocument()
{
    using var client = new HttpClient();
    var request = new HttpRequestMessage
    {
        Method = HttpMethod.Get,
        RequestUri = new Uri(url),
        Headers =
        {
            { "Authorization", "Bearer " + _bearer },
        }
    };

    using var response = await client.SendAsync(request);
    
    // 设置响应状态码
    HttpContext.Response.StatusCode = (int)response.StatusCode;
    
    // 复制响应头部
    foreach (var header in response.Headers)
    {
        HttpContext.Response.Headers.TryAdd(header.Key, header.Value.ToArray());
    }
    foreach (var header in response.Content.Headers)
    {
        HttpContext.Response.Headers.TryAdd(header.Key, header.Value.ToArray());
    }
    
    // 复制响应内容到当前输出流
    await response.Content.CopyToAsync(HttpContext.Response.Body);
    await HttpContext.Response.Body.FlushAsync();
}

额外提示：实际项目中建议通过依赖注入获取HttpClient（在Program.cs中注册builder.Services.AddHttpClient()），而非每次创建新实例，避免因频繁创建客户端导致的socket资源耗尽问题。

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