路由匹配规则
HTTP 网关把请求转发到哪个后端资源,由域名 + 路径两个要素决定。本文说明匹配顺序、优先级,以及一组可直接对照的示例。
匹配要素
| 要素 | 匹配方式 | 说明 |
|---|---|---|
| 域名 | 精确匹配、通配符 * | 精确域名优先于通配符,* 可匹配任意域名,常用于兜底 |
| 路径 | 前缀匹配 | /bar 可匹配 /bar/xxx;同一域名下按最长前缀优先 |
匹配流程
匹配时先找域名,再在该域名下找路径。路径按最长前缀决定,因此精确路径与更短的前缀可以共存,命中更长的那条。
匹配示例
假设配置了以下 6 条路由:
| 域名 | 路径 | 关联资源 |
|---|---|---|
* | / | FunctionA |
* | /bar | FunctionB |
<默认域名> | /bar | FunctionC |
foo.com | / | FunctionD |
foo.com | /bar | FunctionE |
foo.com | /bar/baz | FunctionF |
对应请求的命中结果:
| 访问地址 | 命中资源 | 原因 |
|---|---|---|
<默认域名>/xxx | FunctionA | 默认域名没有专属路由,回落到通配符 *;路径 /xxx 命中前缀 / |
<默认域名>/bar | FunctionC | 精确匹配默认域名,优先于通配符;路径精确命中 /bar |
<默认域名>/bar/xxx | FunctionC | 精确匹配默认域名;路径 /bar/xxx 命中前缀 /bar |
foo.com/xxx | FunctionD | 精确匹配 foo.com,路径 /xxx 命中前缀 / |
foo.com/bar | FunctionE | 精确匹配 foo.com,路径精确命中 /bar |
foo.com/bar/xxx | FunctionE | 精确匹配 foo.com,路径 /bar/xxx 命中前缀 /bar |
foo.com/bar/baz | FunctionF | 精确匹配 foo.com,路径精确命中 /bar/baz,按最长前缀胜过 /bar |
两条结论可以直接记:
- 同域名下,路径越长越优先:
/bar/baz胜过/bar,/bar胜过/ - 同路径下,精确域名优先:
foo.com与<默认域名>各自的/bar互不干扰,只有两者都没命中时才回落到*
配置建议
- 通配符
*只做兜底:配置过于宽松时,任何域名都能借道访问,建议配合安全域名白名单收敛来源 - 按业务前缀分层:如
/api转发到云函数、/static转发到静态托管,避免所有请求落到同一个资源 - 自定义域名接入后单独配路由:域名接入只解决“能不能访问”,能否到达资源取决于是否有匹配路由
排查访问异常
请求返回 404 或无响应时,按以下顺序检查:
| 上游资源 | 配置指引 |
|---|---|
| 云函数 | 通过 HTTP 访问云函数 |
| 静态托管 | 通过 HTTP 访问静态托管 |
| 云托管 | 通过 HTTP 访问云托管 |
| 云存储 | 通过 HTTP 访问云存储 |
使用限制
每个域名下最多配置 100 条路由规则。如需更多,可提交工单申请。