.NET Core 6实现反向代理 转发SOAP请求并添加静态请求头

该需求无需编写复杂的自定义代理逻辑，基于YARP内置的转换能力纯配置即可实现，完美适配.NET 6环境，步骤如下：

1. 项目初始化 #

新建空ASP.NET Core 6项目，通过NuGet安装YARP核心包：
Install-Package Yarp.ReverseProxy

2. 配置Program.cs #

.NET 6采用顶级语句模型，不需要.NET Core 3.1时代的Startup类，直接在Program.cs里注册YARP服务和中间件即可：

var builder = WebApplication.CreateBuilder(args);
// 注册YARP反向代理，从配置文件加载转发规则
builder.Services.AddReverseProxy()
    .LoadFromConfig(builder.Configuration.GetSection("ReverseProxy"));

var app = builder.Build();
// 启用YARP路由匹配与转发管线
app.MapReverseProxy();
app.Run();

3. 配置代理规则与静态请求头 #

直接在appsettings.json里配置转发路由、目标地址，以及需要添加的固定静态请求头，不需要额外编写请求拦截代码：

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "AllowedHosts": "*",
  "ReverseProxy": {
    "Routes": {
      "soap-post-route": {
        "ClusterId": "soap-backend",
        "Match": {
          // 如果SOAP服务有固定路径前缀，可替换为/your-soap-prefix/{**catch-all}做精准匹配
          "Path": "{**catch-all}",
          // 仅匹配POST请求，符合SOAP接口的请求特征
          "Methods": [ "POST" ]
        },
        // 内置请求转换规则，直接配置要添加的静态请求头
        "Transforms": [
          // 格式：{ "RequestHeader": 头名称, "Set": 固定值 }
          { "RequestHeader": "X-Proxy-Source", "Set": "Yarp-Proxy" },
          { "RequestHeader": "X-Auth-Static-Token", "Set": "your-fixed-token-value" },
          // 如果需要移除客户端传来的同名头避免冲突，加对应配置即可
          // { "RequestHeaderRemove": "X-Conflict-Header" },
          // 下游SOAP服务如果校验Host头，放开下面这行替换为目标服务域名
          // { "RequestHeader": "Host", "Set": "target-soap-service.com" }
        ]
      }
    },
    "Clusters": {
      "soap-backend": {
        "Destinations": {
          "soap-server": {
            // 替换为实际的SOAP服务根地址
            "Address": "https://your-actual-soap-service-address/"
          }
        }
      }
    }
  }
}

关键说明 #

• 上述实现为最简方案，全程不需要手写自定义中间件、请求转发逻辑，YARP会自动透传SOAP POST请求的完整报文、原有合法请求头，不会破坏SOAP消息结构，性能远高于.NET Core 3.1时代手写的HttpClient转发代理。
• 配置里的Transforms是YARP官方内置的请求/响应转换能力，除了添加固定请求头，还支持删头、改路径、加响应头等常用操作，足够覆盖常规代理自定义需求。
• 启动项目后直接向代理地址发送SOAP POST请求，下游服务就能收到配置的固定请求头，以及完整的SOAP报文。

踩坑提示：如果遇到下游SOAP服务返回400或者域名校验错误，优先检查Host头是否被正确传递，按照上面注释的配置添加Host头转换即可解决。

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