跳到主要内容

路由匹配规则

HTTP 网关把请求转发到哪个后端资源,由域名 + 路径两个要素决定。本文说明匹配顺序、优先级,以及一组可直接对照的示例。

匹配要素​

要素匹配方式说明
域名精确匹配、通配符 *精确域名优先于通配符,* 可匹配任意域名,常用于兜底
路径前缀匹配/bar 可匹配 /bar/xxx;同一域名下按最长前缀优先

匹配流程​

匹配时先找域名,再在该域名下找路径。路径按最长前缀决定,因此精确路径与更短的前缀可以共存,命中更长的那条。

匹配示例​

假设配置了以下 6 条路由:

域名路径关联资源
*/FunctionA
*/barFunctionB
<默认域名>/barFunctionC
foo.com/FunctionD
foo.com/barFunctionE
foo.com/bar/bazFunctionF

对应请求的命中结果:

访问地址命中资源原因
<默认域名>/xxxFunctionA默认域名没有专属路由,回落到通配符 *;路径 /xxx 命中前缀 /
<默认域名>/barFunctionC精确匹配默认域名,优先于通配符;路径精确命中 /bar
<默认域名>/bar/xxxFunctionC精确匹配默认域名;路径 /bar/xxx 命中前缀 /bar
foo.com/xxxFunctionD精确匹配 foo.com,路径 /xxx 命中前缀 /
foo.com/barFunctionE精确匹配 foo.com,路径精确命中 /bar
foo.com/bar/xxxFunctionE精确匹配 foo.com,路径 /bar/xxx 命中前缀 /bar
foo.com/bar/bazFunctionF精确匹配 foo.com,路径精确命中 /bar/baz,按最长前缀胜过 /bar

两条结论可以直接记:

  • 同域名下,路径越长越优先:/bar/baz 胜过 /bar,/bar 胜过 /
  • 同路径下,精确域名优先:foo.com 与 <默认域名> 各自的 /bar 互不干扰,只有两者都没命中时才回落到 *

配置建议​

  • 通配符 * 只做兜底:配置过于宽松时,任何域名都能借道访问,建议配合安全域名白名单收敛来源
  • 按业务前缀分层:如 /api 转发到云函数、/static 转发到静态托管,避免所有请求落到同一个资源
  • 自定义域名接入后单独配路由:域名接入只解决“能不能访问”,能否到达资源取决于是否有匹配路由

排查访问异常​

请求返回 404 或无响应时,按以下顺序检查:

  1. 域名是否已接入(自定义域名或泛域名接入)
  2. 该域名下是否配置了路由,路径是否为请求路径的前缀
  3. 是否被更长前缀的路由抢先命中,可对照上方示例逐条核对
  4. 后端资源本身是否可用,参考对应接入文档:
上游资源配置指引
云函数通过 HTTP 访问云函数
静态托管通过 HTTP 访问静态托管
云托管通过 HTTP 访问云托管
云存储通过 HTTP 访问云存储

使用限制​

每个域名下最多配置 100 条路由规则。如需更多,可提交工单申请。