如何在ASP.NET网关控制器中自定义ProxyRoute属性以绑定路由与目标API地址？

要实现你想要的优雅方案，我们可以通过创建自定义路由属性来同时保留路由匹配功能和存储目标地址，然后在控制器方法中动态获取当前请求对应的目标地址。下面是具体步骤：

1. 创建自定义ProxyRouteAttribute #

首先我们定义一个继承自RouteAttribute的自定义属性，这样它既拥有原生路由的功能，又能额外存储目标地址：

using Microsoft.AspNetCore.Mvc;

public class ProxyRouteAttribute : RouteAttribute
{
    // 存储目标API地址
    public string Target { get; }

    // 构造函数：接收路由模板和目标地址
    public ProxyRouteAttribute(string routeTemplate, string targetApiUrl) 
        : base(routeTemplate)
    {
        Target = targetApiUrl;
    }
}

2. 编写扩展方法获取当前匹配的Target #

接下来我们需要一个工具方法，从当前请求的上下文里找到匹配的ProxyRouteAttribute，并提取它的Target值。这里我们用扩展方法封装逻辑，方便控制器调用：

using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc.Controllers;
using System.Linq;

public static class HttpContextProxyExtensions
{
    public static string GetProxyTarget(this HttpContext context)
    {
        // 获取当前请求匹配的路由模板
        var matchedRouteTemplate = context.GetRouteData().Route.RouteTemplate;

        // 获取当前控制器的类型信息
        var controllerDescriptor = context.GetEndpoint()?
            .Metadata.GetMetadata<ControllerActionDescriptor>();
        if (controllerDescriptor == null)
            throw new InvalidOperationException("无法获取当前控制器的元数据信息");

        // 从控制器上找到所有ProxyRouteAttribute
        var proxyRoutes = controllerDescriptor.ControllerTypeInfo
            .GetCustomAttributes<ProxyRouteAttribute>(inherit: false);

        // 匹配当前路由对应的ProxyRoute
        var matchedProxyRoute = proxyRoutes.FirstOrDefault(route => 
            route.Template == matchedRouteTemplate);
        
        if (matchedProxyRoute == null)
            throw new InvalidOperationException($"未找到与路由模板 {matchedRouteTemplate} 对应的ProxyRoute配置");

        return matchedProxyRoute.Target;
    }
}

3. 在控制器中使用自定义属性和扩展方法 #

现在就可以按照你想要的方式装饰控制器，并在方法中获取目标地址了（注意修正你原来代码中HttpPost属性里的语法错误）：

[ProxyRoute("api/reporting/route1", "api/reporting/test/1")]
[ProxyRoute("api/reporting/route2", "api/test/2")]
public class TestController : Controller
{
    [HttpPost("{clientId:int}")] // 修正了原来缺少的闭合}
    public async Task<ActionResult<MemoryStream>> GetReport(int clientId, [FromBody] object requestBody)
    {
        // 获取当前请求对应的目标地址
        var targetUrl = HttpContext.GetProxyTarget();
        
        var report = await ReportingClient.DownloadReport(targetUrl, requestBody);
        return File(report, "application/pdf");
    }
}

关键细节说明 #

• 这个方案完全保留了原生路由的匹配逻辑，同时把路由和目标地址的绑定关系通过属性直观地声明在控制器上，比字典方式更符合ASP.NET Core的惯用写法。
• 确保ProxyRouteAttribute的路由模板和实际请求的路由完全匹配（包括斜杠、参数占位符等），否则会找不到对应的Target。
• 如果需要处理更复杂的路由匹配规则（比如带参数的路由模板），可以扩展GetProxyTarget方法中的匹配逻辑，比如利用路由数据的参数来动态拼接目标地址。

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