ASP.NET Core 中的链接生成器如何构建绝对 URL？

答案：LinkGenerator通过提供HttpContext或显式指定scheme和host来生成绝对URL，适用于控制器、中间件及后台任务场景。

在 ASP.NET Core 中，LinkGenerator 用于生成应用内的 URL。要构建绝对 URL（包含协议、主机名和端口的完整地址），你需要提供足够的上下文信息，因为 LinkGenerator 本身是无状态的，不依赖当前 HTTP 上下文。

使用 LinkGenerator 构建绝对 URL

LinkGenerator 提供了多个方法（如 GetPathByAction、GetUriByAction 等）来生成 URL。要生成绝对 URL，推荐使用带有 HttpContext 或显式提供 scheme 和 host 的重载方法。

• 通过 HttpContext 生成绝对 URL

  如果你在控制器或中间件中，可以传入当前的 HttpContext，它包含了 scheme（如 https）、host、port 等信息。

  var uri = _linkGenerator.GetUriByAction(
          action: "GetById",
          controller: "Products",
          values: new { id = 123 },
          context: httpContext,
          fragment: ""
      );

  这会自动生成类似：https://localhost:5001/Products/GetById/123 的绝对 URL。

• 显式指定 Scheme 和 Host

  在后台服务、定时任务或非请求上下文中，没有 HttpContext，这时需要手动提供协议和主机。

  var uri = _linkGenerator.GetUriByAction(
          action: "Index",
          controller: "Home",
          values: null,
          scheme: "https",
          host: new HostString("example.com")
      );

  结果为：https://example.com/

  

  LongCat AI

  美团推出的AI对话问答工具

  下载
• 带端口和路径基础的场景

  如果应用部署在特定端口或子路径下，可进一步配置 HostString 或使用 pathBase。

  var host = new HostString("localhost", 8080);
  var uri = _linkGenerator.GetUriByAction(
      action: "Details",
      controller: "Blog",
      values: new { id = 5 },
      scheme: "http",
      host: host
  );

  输出：http://localhost:8080/Blog/Details/5

在非请求上下文中使用 LinkGenerator

由于 LinkGenerator 是注册为单例或作用域服务的，你可以在任何注入它的类中使用。但在后台任务中必须显式提供 scheme 和 host，否则无法生成绝对路径。

建议将常用的基础 URL 配置在 appsettings.json 中，例如：

"AppSettings": {
  "BaseUrl": "https://yourdomain.com"
}

然后在代码中解析 scheme 和 host 进行调用。

注意事项

• LinkGenerator 不依赖当前请求，适合在服务层、后台任务中使用。
• 生成绝对 URL 必须提供 scheme 和 host，否则返回的是相对路径或不完整 URL。
• 使用 GetUri* 方法才能生成完整 URI；GetPath* 方法仅生成路径部分。
• 注意处理 HTTPS 和反向代理场景下的正确 scheme。