.NET 6 ASP.NET C# 集成Ocelot API网关访问失败问题求助

微服务项目集成Ocelot实现API网关，访问https://localhost:4482/gateway/product时持续返回「无法访问此页面」错误，已核对上下游路由路径未定位到配置疏漏。

现有配置 #

ocelot.json #

{
  "ReRoutes": [
    {
      "DownstreamPathTemplate": "/api/product",
      "DownstreamScheme": "https",
      "DownstreamHostAndPorts": [
        {
          "Host": "localhost",
          "Port": 44
        }
      ],
      "UpstreamPathTemplate": "/gateway/product",
      "UpstreamHttpMethod": [ "GET"]
    },
    {
      "DownstreamPathTemplate": "/api/Order",
      "DownstreamScheme": "https",
      "DownstreamHostAndPorts": [
        {
          "Host": "localhost",
          "Port": 44
        }
      ],
      "UpstreamPathTemplate": "/gateway/Order",
      "UpstreamHttpMethod": [ "GET", "PUT", "POST" ]
    }
  ]
}

Gateway.Program.cs #

using Ocelot.DependencyInjection;
using Ocelot.Middleware;

var builder = WebApplication.CreateBuilder(args);

builder.Configuration.AddJsonFile("ocelot.json");
// Add services to the container.

builder.Services.AddControllers();

// 配置Swagger/OpenAPI相关服务
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();
builder.Services.AddOcelot();
var app = builder.Build();

// Configure the HTTP request pipeline.
if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

app.UseHttpsRedirection();
app.UseOcelot().Wait();

app.UseAuthorization();

app.MapControllers();

app.Run();

按以下优先级逐一排查，可覆盖绝大多数同类问题：

• 修正下游服务端口配置
  当前配置的所有下游服务端口都是44，这是系统HTTPS默认端口，本地开发环境启动的微服务几乎不会监听这个端口，属于高频配置错误。
  1. 先直接访问下游服务原生地址（比如Product服务的https://localhost:[实际端口]/api/product），确认下游服务本身可以正常响应
  2. 将ocelot.json中DownstreamHostAndPorts下的Port值修改为下游服务真实监听的端口号
• 修正Ocelot配置节点名（版本适配问题）
  Ocelot 16.0及以上版本已经将路由配置根节点从ReRoutes重命名为Routes，旧节点名不会被框架识别，会导致所有路由规则失效。直接将ocelot.json中的"ReRoutes"字段名改为"Routes"即可。
• 修正中间件顺序与调用方式
  Ocelot中间件必须放在所有业务相关中间件（授权、控制器路由等）之前，且不要在WebApplication的管道配置中使用.Wait()同步等待，容易造成线程死锁导致请求无响应。调整后的Program.cs管道配置代码如下：

  var app = builder.Build();
  
  // Configure the HTTP request pipeline.
  if (app.Environment.IsDevelopment())
  {
      app.UseSwagger();
      app.UseSwaggerUI();
  }
  
  app.UseHttpsRedirection();
  // Ocelot中间件放在所有业务中间件之前，使用await异步调用
  await app.UseOcelot();
  
  app.UseAuthorization();
  app.MapControllers();
  
  app.Run();
  

• 确认配置文件复制属性
  右键项目中的ocelot.json文件，选择「属性」，将「复制到输出目录」选项设置为如果较新则复制，避免程序运行时找不到配置文件导致所有路由不生效。
• 本地HTTPS证书校验问题处理
  本地开发环境如果使用自签名证书，Ocelot默认会校验下游HTTPS证书的合法性，校验失败会直接终止请求转发。开发环境可以临时关闭证书校验，生产环境禁止使用该配置：

  builder.Services.AddOcelot()
      .AddDelegatingHandler<HttpClientHandler>(_ =>
      {
          return new HttpClientHandler
          {
              ServerCertificateCustomValidationCallback = (_, _, _, _) => true
          };
      });
  

• 开启日志定位具体错误
  如果以上步骤都没解决，给项目添加控制台日志输出，Ocelot会打印路由匹配、请求转发全流程的详细错误信息，可以直接定位到是路由未匹配、下游连接拒绝、还是请求超时等具体问题。

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