ASP.NET Core MVC重定向时无法读取查询字符串参数

ASP.NET Core MVC 应用接收外部站点重定向请求时，所有读取请求路径、完整URL、查询字符串的逻辑均返回空值，[FromQuery] 参数绑定失效；手动将相同URL复制到浏览器地址栏直接访问时，参数读取功能完全正常。

外部跳转目标URL：https://myportal.com/url-redirect?name=test

对应控制器代码：

[HttpGet("/url-redirect")]
public async Task<IActionResult> PortalBack([FromQuery] string name)
{
    var url = HttpContext.Request.Path.ToString(); // 取值为空
    var displayUrl = HttpContext.Request.GetDisplayUrl(); // 取值为空
    var queryString = HttpContext.Request.QueryString.ToString(); // 取值为空
    
    return View();
}

该问题出在请求链路的转发环节，和控制器本身的参数绑定、URL读取代码无关：
手动访问正常说明应用本身的代码逻辑没有问题，外部重定向访问异常，说明请求从外部到应用的传输过程中，原始路径、查询参数被中间节点（反向代理、负载均衡、CDN、WAF、应用内自定义重写规则）清空或重写了。

按优先级从高到低排查：

• 检查反向代理/负载均衡转发配置
  绝大多数场景是反向代理转发规则配置错误，没有携带原始请求的路径和查询字符串：
  • 如果用Nginx做反向代理，检查proxy_pass配置，必须携带$request_uri参数保留原始请求信息，正确配置参考：

    location / {
        proxy_pass http://应用内网监听地址$request_uri;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
    

  • 如果用IIS ARR、云厂商负载均衡/CDN/WAF，检查转发规则配置，开启「保留原始查询字符串」「保留原始请求路径」选项，不要配置会把路径重写为空的规则。
• 配置ASP.NET Core转发头中间件
  如果部署在反向代理之后，没有正确配置转发头中间件也会导致应用无法识别原始请求信息。在Program.cs中把转发头中间件放到所有其他中间件的最前面：

  builder.Services.Configure<ForwardedHeadersOptions>(options =>
  {
      options.ForwardedHeaders = ForwardedHeaders.XForwardedFor | ForwardedHeaders.XForwardedProto;
      // 将反向代理的内网IP加入已知代理列表，避免中间件忽略转发头
      options.KnownProxies.Add(IPAddress.Parse("反向代理服务器内网IP"));
  });
  
  // 必须放在UseRouting、UseAuthorization、MapControllerRoute等所有中间件之前
  app.UseForwardedHeaders();
  

• 排查应用内URL重写规则
  检查应用是否配置了自定义URL Rewrite中间件、自定义中间件逻辑，在请求到达控制器之前清空了Request.Path和Request.QueryString，临时禁用所有自定义中间件测试即可定位。
• 验证跳转请求方法
  抓包查看外部站点的跳转响应：如果外部站点用307/308状态码跳转POST请求到你的接口，而你的接口只标记了[HttpGet]，会出现请求匹配异常。这种场景要么协调外部站点改用GET方式跳转，要么给接口加上[AcceptVerbs("GET", "POST")]特性同时支持两种请求方法。
• 快速验证方法
  绕过反向代理，直接通过服务器内网IP+应用监听端口访问带查询参数的目标URL，如果此时能正常读取参数，即可确定问题完全出在反向代理/转发环节，和应用代码无关。

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