路由匹配规则

HTTP 网关提供灵活的路由配置能力，让您可以将请求精准路由至云托管、云函数、静态托管、云存储等多种后端资源，实现统一的请求分发管理。

路由配置由两个核心要素组成：域名（domain）和路径（path）。系统根据这两个要素按照特定优先级进行匹配。

匹配优先级

1. 域名匹配：

   • 精确匹配（如 example.com ）优先级高于通配符匹配（如 * ）
   • 支持使用通配符 * 匹配任意域名

2. 路径匹配：

   • 遵循最长匹配原则，系统会优先选择与请求路径重合度最高的规则
   • 路径匹配是前缀匹配，如 /bar 可以匹配 /bar/xxx

匹配流程图

路由匹配示例

以下表格展示了一组路由规则配置：

域名	路径	关联资源
*	/	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 （最长匹配原则）

路由相关限制

当前可在每个域名下配置 100 条路由规则。 如果您有更多路由需求，可以提交工单进行申请。