.NET Framework迁移.NET6：配置YARP强制特定端点代理至旧API

要实现特定端点强制跳过新API、直接代理到旧API，核心是调整路由匹配优先级——给目标端点配置优先级更高的YARP转发规则，让请求先匹配到代理规则，而非已存在的新端点。

具体实现步骤 #

1. 新增高优先级的特定代理规则
   在原有全局代理规则之前，注册针对目标端点的转发规则，并设置比默认路由更低的Order值（Order越小，路由优先级越高）。由于控制器端点的默认Order是0，我们将代理规则的Order设为-1，确保它优先级高于所有新端点。

2. 示例代码
   假设你需要强制代理/api/users和/api/orders这两个端点，配置如下：

   // 注册特定端点的强制代理规则，优先级高于新端点
   app.MapForwarder("/api/users/{**catch-all}", app.Configuration["ProxyTo"]!)
      .Add(static builder => ((RouteEndpointBuilder)builder).Order = -1);
   
   app.MapForwarder("/api/orders/{**catch-all}", app.Configuration["ProxyTo"]!)
      .Add(static builder => ((RouteEndpointBuilder)builder).Order = -1);
   
   // 原有低优先级全局代理规则（仅匹配未被新端点或特定代理规则覆盖的请求）
   app.MapForwarder("/{**catch-all}", app.Configuration["ProxyTo"]!)
      .Add(static builder => ((RouteEndpointBuilder)builder).Order = int.MaxValue);
   

3. 批量配置简化方式
   如果有一组前缀相同的端点需要强制代理，可以用通配符批量匹配（比如所有/api/legacy开头的请求）：

   app.MapForwarder("/api/legacy/{**catch-all}", app.Configuration["ProxyTo"]!)
      .Add(static builder => ((RouteEndpointBuilder)builder).Order = -1);
   

原理说明 #

ASP.NET Core路由系统会按Order值从小到大匹配规则：

• 控制器端点默认Order为0，我们将代理规则设为-1，确保请求先匹配到代理规则；
• 原有全局代理规则Order设为int.MaxValue，仅处理未被新端点或特定代理规则覆盖的请求。

内容的提问来源于stack exchange，提问作者Mateusz S.