.NET6使用Ocelot网关时微服务如何获取网关地址生成分页链接

问题本质是默认配置下Ocelot不会把网关侧的原始请求主机信息透传给下游微服务，微服务读取当前请求上下文拿到的是自身服务的监听地址，自然生成的分页链接带的是5001/5002端口。按以下两步配置即可解决，不需要额外在微服务里硬编码网关地址。

1. 配置Ocelot网关透传原始请求头 #

打开网关项目的ocelot.json配置文件，给需要透传主机信息的路由添加请求头转发规则，同时配置全局网关基地址：

{
  "Routes": [
    {
      "DownstreamPathTemplate": "/api/{everything}",
      "DownstreamScheme": "https",
      "DownstreamHostAndPorts": [
        { "Host": "localhost", "Port": 5001 },
        { "Host": "localhost", "Port": 5002 }
      ],
      "UpstreamPathTemplate": "/api/{everything}",
      "UpstreamHttpMethod": ["Get", "Post", "Put", "Delete"],
      // 新增以下配置，将网关收到的原始Host、协议头传给下游
      "AddHeadersToRequest": {
        "X-Forwarded-Host": "{Host}",
        "X-Forwarded-Proto": "{Scheme}"
      }
    }
  ],
  "GlobalConfiguration": {
    "BaseUrl": "https://localhost:5000"
  }
}

如果所有路由都需要透传该头，可以在全局配置中统一添加，不用每个路由单独配置。

2. 微服务侧开启转发头识别 #

在两个业务微服务的Program.cs中，注册并启用.NET原生的转发头中间件，注意该中间件必须放在所有依赖请求上下文的中间件（路由、鉴权、控制器等）之前，否则不生效：

var builder = WebApplication.CreateBuilder(args);

// 配置转发头信任规则
builder.Services.Configure<ForwardedHeadersOptions>(options =>
{
    options.ForwardedHeaders = Microsoft.AspNetCore.HttpOverrides.ForwardedHeaders.All;
    // 本地开发环境同机部署时清空已知代理/网络列表，避免环回地址的转发头被拦截
    options.KnownNetworks.Clear();
    options.KnownProxies.Clear();
});

var app = builder.Build();

// 这行必须放在最前面
app.UseForwardedHeaders();

// 后续保留你原来的中间件配置即可，比如：
// app.UseHttpsRedirection();
// app.UseRouting();
// app.UseAuthorization();
// app.MapControllers();

app.Run();

配置完成后重启网关和微服务，你现有的分页链接生成逻辑不需要做任何修改——HttpContext.Request里的Scheme、Host会自动替换为网关侧的原始值，生成的链接自然就是https://localhost:5000开头的地址。

可选：按需读取转发头（不修改全局请求上下文） #

如果你的业务场景里部分接口需要返回微服务直连地址、部分需要返回网关地址，不需要启用全局转发头中间件，直接在生成分页链接的代码里手动读取转发头兜底即可：

// 优先取网关透传的主机，没有就用当前请求的主机
var host = Request.Headers.TryGetValue("X-Forwarded-Host", out var fHost) 
    ? fHost.First() 
    : Request.Host.Value;
var scheme = Request.Headers.TryGetValue("X-Forwarded-Proto", out var fScheme)
    ? fScheme.First()
    : Request.Scheme;

// 用scheme + host拼分页链接即可

生产环境注意事项 #

生产部署时不要清空KnownProxies和KnownNetworks，需要把网关服务的固定IP/网段加入信任列表，避免恶意请求伪造转发头生成非法链接。

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