.NET 5使用Refit调用API出现502 Bad Gateway异常问题咨询

问题根因 #

这一问题本质是违反HTTP规范使用GET请求携带请求体，叠加.NET HttpClient的默认行为差异共同导致的：

1. 按照HTTP RFC规范，GET请求本身不应该携带请求体，绝大多数反向代理、网关、Web服务器要么会直接丢弃GET请求的Body，要么会直接拒收请求返回错误码，你遇到的502错误就是这类基础设施拦截导致的。
2. .NET HttpClient针对GET请求有特殊处理逻辑：如果请求携带了Body但从未被读取消费过，HttpClient默认不会计算Content-Length头，也不会将Body实际发送到服务端，导致服务端[FromBody]参数绑定直接失败。而你调用request.Content.ReadAsStringAsync()时，请求Body会被缓冲到内存中，HttpClient会自动补充Content-Length头，完整发送整个请求，反而能正常命中服务端的绑定逻辑，这就是加日志就正常、删日志就报错的核心原因。

解决方案 #

最优方案（推荐）：将接口改为POST请求 #

GET请求天生不适合携带复杂请求参数，改为POST符合HTTP规范，也不会有后续的兼容问题：

1. 修改Refit接口声明：

// 把[Get]改成[Post]
[Post("/projects/private/list")]
[Headers("Authorization: Bearer")]
Task<List<ProjectsResponse>> GetProjects([Body] ProjectsRequest projectIds);

2. 修改服务端端点定义：

// 把[HttpGet]改成[HttpPost]
[HttpPost("private/list")]
[ProducesResponseType(statusCode: (int)HttpStatusCode.OK, type: typeof(IEnumerable<ProjectsResponse>))]
public async Task<IActionResult> GetProjects([FromBody] ProjectsRequest request)
{
    // 原有逻辑保持不变
}

替代方案：参数改为查询字符串传递 #

如果你坚持要用GET请求，可以把参数从Body移到查询字符串中：

1. 修改Refit接口声明，去掉[Body]标记：

[Get("/projects/private/list")]
[Headers("Authorization: Bearer")]
Task<List<ProjectsResponse>> GetProjects([FromQuery] ProjectsRequest projectIds);

2. 修改服务端端点，把[FromBody]改为[FromQuery]：

[HttpGet("private/list")]
[ProducesResponseType(statusCode: (int)HttpStatusCode.OK, type: typeof(IEnumerable<ProjectsResponse>))]
public async Task<IActionResult> GetProjects([FromQuery] ProjectsRequest request)
{
    // 原有逻辑保持不变
}

注意：这个方案仅适合ProjectIds数量较少的场景，如果ID数量过多会超出查询字符串的长度限制。

临时兼容方案 #

如果你暂时不想修改接口定义，需要保留日志代码的话，要注意请求Body流是只读一次的，读取后需要重置请求Content，避免后续逻辑读取失败：

var contentStr = await request.Content.ReadAsStringAsync();
_logger.LogInformation("Request:{data}", contentStr);
// 重置请求Content
var bytes = Encoding.UTF8.GetBytes(contentStr);
request.Content = new ByteArrayContent(bytes);
request.Content.Headers.ContentType = new System.Net.Http.Headers.MediaTypeHeaderValue("application/json");

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