文档中心

API 网关

路由管理

创建重定向路由

路由用于匹配请求并执行相应的流量处理策略，支持按权重将请求分发至多个目标 Upstream、返回自定义 Mock 响应或将请求直接重定向至指定地址，适用于多版本流量管理、接口联调等场景。本文为您介绍如何创建重定向路由。

背景信息

重定向路由是 API 网关提供的一种特殊路由。请求命中匹配规则后，API 网关不会将请求转发至后端 Upstream，而是返回 3xx 状态码，并通过Location响应头告知客户端新的访问地址。

重定向路由适用于域名迁移、接口路径调整、API 版本切换和旧入口兼容等场景。通过在网关侧统一调整访问入口，无需修改后端 Upstream，即可保留旧地址的可访问性，减少客户端立即改造的成本，降低域名或路径变更对已有调用方的影响。

前提条件

已创建服务，详情可参见创建服务。

使用限制

存在多条路由规则时，按照自定义优先级 > 路径（Path）> 请求头（Header）> 请求参数（Query）> 创建时间的优先级从高到低依次进行排序。如果多条路由规则存在路径（Path）配置重叠，且优先级一致时，则来自重叠路径的请求会被转发至最早创建的路由。路由匹配优先级详情可参见路由概述。

当使用场景选择重定向时，高级配置仅支持跨域配置。

操作步骤

创建路由时，支持在服务配置页面中，为该服务创建单条路由。也支持在路由列表中，为多个服务批量创建路由。

在顶部导航栏，选择目标地域。

在实例管理下拉框选择目标实例。在左侧导航栏选择服务列表（域名），在服务列表页面，单击目标服务操作列下的创建路由。

在创建路由页面，配置路由信息。

基本信息、使用场景和匹配规则

配置项	说明
路由名称	自定义路由名称。同一服务下路由名称唯一。
所属服务	配置路由所属服务。支持多选，允许快速创建多条路由。
使用场景	选择路由的执行场景。本实例选择重定向，表示配置重定向路由。说明仅在服务配置页面中，为该服务创建单条路由时支持选择使用场景。
匹配规则	配置匹配规则，只有符合规则的请求才能转发至目标 Upstream。请求方法 Method：只允许符合指定方法的请求进行访问。支持以下请求方法。 GET：查询资源信息，用于获取资源详情。 POST：提交请求数据，常用于新增、创建业务资源，也可用于触发各类业务操作，例如暂停任务、下发配置等。 PUT：全量替换指定资源。 DELETE：删除目标资源。 HEAD：查询资源信息，仅返回响应头，不返回响应体。 OPTIONS：查询目标接口支持的 HTTP 请求方法、跨域访问策略等元信息。 PATCH：对资源进行局部增量更新，仅修改变更字段。 CONNECT：建立 TCP 网络隧道，常用于 HTTPS 代理穿透场景。路径 Path：指定允许访问的请求路径。支持 3 种匹配方式，示例请参考路径匹配示例。精准匹配：表示请求的路径和设置的路径完全一致，请求才会被转发。正则匹配：表示请求的路径和设置的路径正则表达式匹配，请求才会被转发。前缀匹配：表示请求的路径只要匹配已设定路径的开头，请求才会被转发。说明 Path 的优先级由高到低为：精准匹配 > 前缀匹配 > 正则匹配。请求头 Header：只允许包含了指定请求头 Header 的请求进行访问。支持添加多条请求 Header。 Header key：支持英文字母、数字和中划线-、下划线_。匹配类型：指定 Header 的匹配方式，支持精确匹配、正则匹配和前缀匹配。 Header value：校验 ASCII 码范围。请求参数 QueryString：只允许包含了指定访问参数的请求进行访问。支持添加多条请求参数。优先级：输入路由匹配规则的优先级。整数形式，取值范围为 0～100。数字越小，优先级越高。匹配规则的精确度越高优先级越高。例如，path:/abc, header:version=v1优先级高于path:/abc，与创建时间无关。

重定向配置

请求匹配重定向路由规则后，网关将向客户端返回重定向响应。

说明

当前使用场景不会转发到后端 Upstream，请确认匹配规则和返回配置符合预期。

配置项	说明
重定向状态码	选择重定向状态码。取值： 301 302 303 307 308
域名	配置重定向的域名。说明重定向域名或路径至少配置一项。若不配置则保持域名不变。
路径	配置重定向的路径，须以/开头，可使用 ASCII 可打印字符。说明重定向域名或路径至少配置一项。若不配置则保持路径不变。

高级配置

路由策略的高级配置参见路由策略。

单击确定，完成路由创建。

路径匹配示例

路径匹配示例，如下表所示。

匹配方式	请求路径	设定路径
匹配方式	请求路径			/apig/test.jpg	/apig	/apig[^\s]*
精准匹配	/apig/test.jpg	√	-	-
正则匹配			√	-	√
前缀匹配			√	√	-

结果验证

验证示例

创建重定向路由后，在终端访问服务域名和路由路径，验证 API 网关是否将请求直接重定向至指定地址。示例中重定向路由重定向状态码配置为301，域名配置为test.com。

执行以下命令。请将 <服务域名> 替换为目标服务的实际域名。

curl -i https://<服务域名>

预期返回结果如下。

HTTP/1.1 301 Moved Permanently
location: http://test.com/
date: Thu, 08 Oct 2026 07:49:21 GMT
server: istio-envoy
content-length: 0

查看配置

支持查看路由的基本信息、具体匹配规则和重定向配置信息。

在实例管理下拉框选择目标实例后，单击路由列表。

在路由列表中，支持检索和查看路由的基本信息。

在所属实例、所属服务下拉菜单中选择筛选项，可以基于筛选项对路由进行筛选。

路由列表中展示了路由的基本信息，包括：名称/ID、状态、优先级、使用场景、域名、路由 Path 等。

说明

多个筛选项之间是并关系，即同时符合所有筛选项的路由，才会被筛选出来。

单击目标路由名称，进入路由概览页面。即可查看路由的基本信息、匹配规则和重定向配置等信息。

最近更新时间：2026.10.16 16:00:15

这个页面对您有帮助吗？

有用

无用