迁移至ASP.NET Core后无法在DelegatingHandler中获取IUrlHelper

你遇到的问题其实是ASP.NET Core和传统ASP.NET Web API的管道模型、服务获取方式差异导致的——原来基于HttpRequestMessage的IUrlHelper获取方式在Core里已经不适用，对应的旧扩展包也不再兼容。下面分两种场景给你具体的解决方案：

场景1：你的Handler用于HttpClient（调用外部API时的请求处理） #

如果这个LinkDecoratorHandler是给HttpClient使用的（比如用来处理向外发送的请求），可以按以下步骤调整：

1. 注入必要服务
   在Startup.cs（或Program.cs的服务配置部分）添加以下注册：

   services.AddSingleton<IActionContextAccessor, ActionContextAccessor>();
   services.AddScoped<IUrlHelperFactory>();
   

2. 修改Handler的实现
   通过构造函数注入所需服务，从HttpRequestMessage的属性中获取HttpContext，再创建IUrlHelper实例：

   using Microsoft.AspNetCore.Mvc;
   using Microsoft.AspNetCore.Mvc.Infrastructure;
   using System.Net.Http;
   using System.Threading;
   using System.Threading.Tasks;
   
   public class LinkDecoratorHandler : DelegatingHandler
   {
       private readonly IUrlHelperFactory _urlHelperFactory;
       private readonly IActionContextAccessor _actionContextAccessor;
   
       // 通过构造函数注入服务，不要直接new实例
       public LinkDecoratorHandler(IUrlHelperFactory urlHelperFactory, IActionContextAccessor actionContextAccessor)
       {
           _urlHelperFactory = urlHelperFactory;
           _actionContextAccessor = actionContextAccessor;
       }
   
       protected override async Task<HttpResponseMessage> SendAsync(HttpRequestMessage request, CancellationToken cancellationToken)
       {
           // 从HttpRequestMessage中提取HttpContext
           if (request.Properties.TryGetValue("Microsoft.AspNetCore.Http.HttpContext", out var contextObj) 
               && contextObj is HttpContext httpContext)
           {
               // 获取或创建ActionContext
               var actionContext = _actionContextAccessor.ActionContext 
                   ?? new ActionContext(httpContext, httpContext.GetRouteData(), new Microsoft.AspNetCore.Mvc.Abstractions.ActionDescriptor());
               
               // 创建IUrlHelper实例
               var urlHelper = _urlHelperFactory.GetUrlHelper(actionContext);
               
               // 这里就可以用urlHelper生成链接了，比如：
               var selfLink = urlHelper.Link("YourRouteName", new { id = 123 });
               // 执行你原来的逻辑，比如给请求或响应添加链接信息
           }
   
           var response = await base.SendAsync(request, cancellationToken);
           // 处理响应的逻辑
           return response;
       }
   }
   

3. 注册Handler到HttpClient
   不要直接newHandler，而是通过DI容器注册：

   services.AddTransient<LinkDecoratorHandler>();
   
   // 注册你的HttpClient并添加Handler
   services.AddHttpClient("YourClientName")
           .AddHttpMessageHandler<LinkDecoratorHandler>();
   

场景2：你的Handler是服务器端请求处理器（处理进来的API请求） #

如果原来的LinkDecoratorHandler是用来处理服务器收到的请求（对应传统Web API的config.MessageHandlers.Add()场景），那ASP.NET Core里已经不再使用这种服务器端MessageHandler机制，建议迁移为中间件：

1. 创建中间件类

   using Microsoft.AspNetCore.Http;
   using Microsoft.AspNetCore.Mvc;
   using Microsoft.AspNetCore.Mvc.Abstractions;
   using Microsoft.AspNetCore.Mvc.Infrastructure;
   using System.IO;
   using System.Text;
   using System.Threading.Tasks;
   
   public class LinkDecoratorMiddleware
   {
       private readonly RequestDelegate _next;
       private readonly IUrlHelperFactory _urlHelperFactory;
       private readonly IActionContextAccessor _actionContextAccessor;
   
       public LinkDecoratorMiddleware(RequestDelegate next, IUrlHelperFactory urlHelperFactory, IActionContextAccessor actionContextAccessor)
       {
           _next = next;
           _urlHelperFactory = urlHelperFactory;
           _actionContextAccessor = actionContextAccessor;
       }
   
       public async Task InvokeAsync(HttpContext context)
       {
           // 启用响应缓冲，方便后续读取和修改响应内容
           context.Response.EnableBuffering();
   
           // 获取或创建ActionContext
           var actionContext = _actionContextAccessor.ActionContext;
           if (actionContext == null)
           {
               var routeData = context.GetRouteData();
               var actionDescriptor = context.Features.Get<IActionDescriptorFeature>()?.ActionDescriptor;
               actionContext = new ActionContext(context, routeData, actionDescriptor);
           }
   
           // 创建IUrlHelper实例
           var urlHelper = _urlHelperFactory.GetUrlHelper(actionContext);
           
           // 执行你原来的请求处理逻辑，比如把urlHelper存入上下文供后续使用
           context.Items["CurrentUrlHelper"] = urlHelper;
   
           // 调用下一个中间件（继续处理请求）
           await _next(context);
   
           // 处理响应的逻辑，比如在响应中添加链接
           if (context.Response.StatusCode == StatusCodes.Status200OK)
           {
               // 读取响应内容
               context.Response.Body.Seek(0, SeekOrigin.Begin);
               var responseContent = await new StreamReader(context.Response.Body).ReadToEndAsync();
               context.Response.Body.Seek(0, SeekOrigin.Begin);
   
               // 示例：给JSON响应添加self链接字段
               // var modifiedContent = JObject.Parse(responseContent)
               //     .Add("selfLink", urlHelper.Link("YourRouteName", new { id = context.GetRouteValue("id") }))
               //     .ToString();
               // var bytes = Encoding.UTF8.GetBytes(modifiedContent);
               // await context.Response.Body.WriteAsync(bytes, 0, bytes.Length);
               // context.Response.Body.Seek(0, SeekOrigin.Begin);
           }
       }
   }
   

2. 注册中间件
   在Startup.cs（或Program.cs的管道配置部分）添加中间件，注意顺序要放在UseRouting和UseEndpoints之间：

   app.UseRouting();
   // 添加你的中间件
   app.UseMiddleware<LinkDecoratorMiddleware>();
   app.UseEndpoints(endpoints =>
   {
       endpoints.MapControllers();
   });
   

3. 注入必要服务
   同样需要在服务配置部分注册：

   services.AddSingleton<IActionContextAccessor, ActionContextAccessor>();
   services.AddScoped<IUrlHelperFactory>();
   

补充说明 #

• 不需要额外安装NuGet包：IUrlHelperFactory等类型都包含在Microsoft.AspNetCore.Mvc.Core中，而这个包已经集成在Microsoft.AspNetCore.App元包里，默认会被引用。
• 避免直接new实例：所有依赖的服务都要通过DI容器注入，不要手动new，否则会导致服务无法正确初始化。

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