ASP.NET Core中能否实现拦截所有重定向的全局拦截器

ASP.NET Core完全支持该需求，无需业务开发者修改任何重定向相关的业务代码，不需要在控制器、页面、自定义组件里加额外埋点，通过框架内置的请求管道扩展点，就能100%捕获应用运行过程中所有返回给客户端的重定向行为。

ASP.NET Core中所有重定向行为，不管是调用HttpResponse.Redirect()方法、MVC/Razor Pages返回RedirectResult/RedirectToActionResult/RedirectToPageResult，还是自定义组件直接设置3xx状态码和Location响应头，最终在响应发送给客户端前，都会把状态码和目标地址写入响应对象。我们只需要在请求管道中注册一个全局中间件，在响应发送前的钩子中读取状态码和目标地址，即可完成全量重定向记录。

• 第一步：定义重定向记录存储服务
  先定义记录实体和存储接口，用来持久化重定向数据供管理面板查询，示例代码：

  // 重定向记录实体，可按需扩展字段
  public class RedirectRecord
  {
      public long Id { get; set; }
      public string RequestPath { get; set; } = string.Empty;
      public string RequestMethod { get; set; } = string.Empty;
      public int StatusCode { get; set; }
      public string TargetUrl { get; set; } = string.Empty;
      public string? ClientIp { get; set; }
      public DateTimeOffset OccurTime { get; set; }
  }
  
  // 存储接口，可按需实现为内存存储、数据库存储、日志存储
  public interface IRedirectRecordStore
  {
      void Save(RedirectRecord record);
      List<RedirectRecord> Query(/* 按需加时间范围、状态码等查询参数 */);
  }
  

• 第二步：实现全局重定向捕获中间件
  利用框架提供的Response.OnStarting()钩子，在响应发送给客户端前拦截检测重定向响应，示例代码：

  public class RedirectCaptureMiddleware
  {
      private readonly RequestDelegate _next;
  
      public RedirectCaptureMiddleware(RequestDelegate next)
      {
          _next = next;
      }
  
      public async Task InvokeAsync(HttpContext context, IRedirectRecordStore recordStore)
      {
          // 注册响应发送前的回调：所有响应头、状态码设置完成后、响应内容发送前触发
          context.Response.OnStarting(() =>
          {
              var statusCode = context.Response.StatusCode;
              // 匹配所有标准重定向状态码
              if (statusCode is StatusCodes.Status301MovedPermanently
                  or StatusCodes.Status302Found
                  or StatusCodes.Status303SeeOther
                  or StatusCodes.Status307TemporaryRedirect
                  or StatusCodes.Status308PermanentRedirect)
              {
                  var targetUrl = context.Response.Headers.Location.ToString();
                  if (!string.IsNullOrWhiteSpace(targetUrl))
                  {
                      // 写入重定向记录
                      recordStore.Save(new RedirectRecord
                      {
                          RequestPath = context.Request.Path + context.Request.QueryString,
                          RequestMethod = context.Request.Method,
                          StatusCode = statusCode,
                          TargetUrl = targetUrl,
                          ClientIp = context.Connection.RemoteIpAddress?.ToString(),
                          OccurTime = DateTimeOffset.UtcNow
                      });
                  }
              }
              return Task.CompletedTask;
          });
  
          // 将请求传递给管道下一个组件
          await _next(context);
      }
  }
  

• 第三步：注册服务和中间件到应用
  在Program.cs中注册存储服务，并且把捕获中间件放到请求管道的合适位置：中间件必须放在所有可能产生重定向的组件之前注册，才能保证所有重定向都被拦截。示例配置：

  var builder = WebApplication.CreateBuilder(args);
  
  // 注册重定向记录存储服务，示例为单例内存存储，生产环境可替换为数据库存储
  builder.Services.AddSingleton<IRedirectRecordStore, InMemoryRedirectRecordStore>();
  // 注册原有MVC、Razor Pages等服务
  builder.Services.AddControllersWithViews();
  builder.Services.AddRazorPages();
  
  var app = builder.Build();
  
  // 先配置异常处理、静态文件等前置中间件
  if (!app.Environment.IsDevelopment())
  {
      app.UseExceptionHandler("/Home/Error");
  }
  app.UseStaticFiles();
  
  // 重定向捕获中间件放在路由、授权、端点映射之前
  app.UseMiddleware<RedirectCaptureMiddleware>();
  
  // 后续保留原有管道配置
  app.UseHttpsRedirection();
  app.UseRouting();
  app.UseAuthorization();
  app.MapControllerRoute(
      name: "default",
      pattern: "{controller=Home}/{action=Index}/{id?}");
  app.MapRazorPages();
  
  app.Run();
  

• 第四步：对接管理面板
  实现管理面板对应的查询接口，从IRedirectRecordStore中拉取重定向记录，按需做筛选、分页、统计展示即可。

• 如果不需要统计系统级重定向（比如HTTPS强制跳转、未授权用户自动跳登录页），可以在记录保存逻辑中加过滤规则，跳过这类固定规则产生的重定向。
• OnStarting回调执行时响应即将发送，不要在回调中做耗时的同步IO操作，建议存储逻辑用后台队列异步写入，避免阻塞响应、拖慢接口性能。
• 该方案对应用原有逻辑完全无侵入，后续新增的业务代码不需要做任何适配，所有符合HTTP标准的重定向都会被自动捕获。

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