.NET 8 Azure Functions孤立进程获取客户端IP异常（疑似变更）

问题背景 #

我们将作为静态Web App API的Azure Functions（Bring Your Own Functions模式）从.NET 7孤立工作进程升级到.NET 8后，出现X-Forwarded-For请求头完全丢失的异常：

• .NET 7环境正常：X-Forwarded-For包含以客户端IP为首的逗号分隔IP列表，Host头为Azure Functions的DNS条目；
• .NET 8环境异常：导出所有请求头均找不到X-Forwarded-For或类似头，ASP.NET Core中间件仅把Azure数据中心IP设为RemoteIpAddress，Host头变为localhost:port，且请求头大小写存在差异，推测存在不同的代码路径或配置逻辑。
  注：业务代码未做任何修改，问题仅出现在该特定部署场景中。

排查与解决方案建议 #

1. 配置.NET 8 孤立进程的正向代理信任规则 #

.NET 8调整了ASP.NET Core的正向代理处理逻辑，需明确信任Azure代理：

• 在host.json中添加正向代理配置：

{
  "extensions": {
    "http": {
      "forwarding": {
        "trustedProxies": ["AzureCloud"],
        "allowedHosts": ["你的静态Web App域名.azurestaticapps.net"]
      }
    }
  }
}

• 若使用自定义启动逻辑，在Program.cs中手动配置转发头中间件：

builder.Services.Configure<ForwardedHeadersOptions>(options =>
{
    options.ForwardedHeaders = ForwardedHeaders.XForwardedFor | ForwardedHeaders.XForwardedProto;
    // 信任Azure数据中心IP段，可添加多个
    options.KnownNetworks.Add(new IPNetwork(IPAddress.Parse("13.64.0.0"), 11));
    options.KnownNetworks.Add(new IPNetwork(IPAddress.Parse("13.77.0.0"), 11));
});

2. 验证静态Web App与Functions的集成配置 #

检查静态Web App的BYOF集成设置：

• 确认API路由转发规则未修改，确保请求头完整传递；
• 检查静态Web App的"API设置"中，未启用会篡改请求头的选项；
• 确认Functions的访问控制策略未限制代理请求的头信息流转。

3. 适配.NET 8的请求头解析逻辑 #

由于请求头大小写存在差异，可调整代码中获取头的方式：

• 改用不区分大小写的方式获取头，比如：

var xForwardedFor = request.Headers["x-forwarded-for"].FirstOrDefault();

• 启用Functions的详细日志，查看请求到达前的头信息流转，确认是否在转发环节被丢弃。

4. 确认是否为官方回归问题 #

• 查阅.NET 8 Azure Functions的官方更新日志，确认是否存在相关的头处理回归bug；
• 若为已知问题，可临时回退到.NET 7，或等待官方补丁；
• 也可在Azure Functions官方反馈渠道提交问题，附带场景复现细节。

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