YARP反向代理中修改请求体的正确方式

在开发基于YARP（Yet Another Reverse Proxy）的中间件时，我们可能会遇到需要动态修改HTTP请求的场景。本文将深入探讨如何在中间件中正确修改请求体，特别是当需要将GET请求转换为POST请求时。

问题背景

在YARP项目中，开发者有时需要在中间件中修改传入的HTTP请求。一个典型场景是：当GET请求包含特定查询参数时，我们希望将其转换为POST请求，并将查询参数值作为请求体发送。

常见误区

许多开发者会尝试直接修改请求的属性和流：

public Task Invoke(HttpContext context)
{
    if (HttpMethods.IsGet(context.Request.Method) 
    {
        context.Request.Method = HttpMethods.Post;
        var queryBytes = Encoding.UTF8.GetBytes("test");
        context.Request.ContentLength = queryBytes.Length;
        context.Request.Body = new MemoryStream(queryBytes);
    }
    return _next(context);
}

然而，这种做法会导致系统抛出异常："Sent 0 request content bytes, but Content-Length promised 4"。这是因为YARP内部对请求体的检测机制没有考虑到请求体被动态创建的情况。

解决方案

方法一：重置请求体检测特性

最直接的解决方案是重置IHttpRequestBodyDetectionFeature：

context.Request.Body = new MemoryStream(queryBytes);
context.Features.Set<IHttpRequestBodyDetectionFeature>(null);

这种方法简单有效，但可能不是最优雅的方案。

方法二：实现自定义请求体检测特性

更规范的做法是实现自定义的IHttpRequestBodyDetectionFeature：

class CustomBodyDetectionFeature : IHttpRequestBodyDetectionFeature
{
    public bool CanHaveBody => true;
}

// 使用方式
context.Request.Body = new MemoryStream(queryBytes);
context.Features.Set<IHttpRequestBodyDetectionFeature>(new CustomBodyDetectionFeature());

这种方法更符合ASP.NET Core的设计理念，明确告知框架该请求现在可以包含请求体。

注意事项

1. 查询参数处理：转换GET到POST后，记得从查询字符串中移除已用作请求体的参数，避免重复。

2. 内容类型设置：根据实际需求，可能需要设置Content-Type头部。

3. 流位置重置：确保新创建的MemoryStream的位置在0，否则可能导致读取不到数据。

最佳实践

对于这种不常见的请求转换，建议：

1. 在中间件开头明确记录转换操作
2. 验证输入数据的有效性
3. 考虑添加特定的响应头表明请求已被转换
4. 在文档中明确说明这种特殊行为

总结

在YARP中动态修改请求体需要特别注意框架内部的请求体检测机制。通过正确实现或重置IHttpRequestBodyDetectionFeature，我们可以安全地将GET请求转换为POST请求并设置自定义请求体。这种技术虽然不常见，但在某些特殊场景下非常有用，如实现特定的API兼容层或处理遗留系统接口。