文档中心

API 网关

路由管理

创建 Mock 路由

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

背景信息

Mock 路由是一种由 API 网关直接返回预设响应的路由。请求命中 Mock 路由的匹配规则后，API 网关不会将请求转发至后端 Upstream，而是直接向客户端返回预先配置的响应状态码和响应体。

Mock 路由适用于后端接口尚未开发完成、后端服务暂时不可用，或需要模拟指定状态码和响应内容的场景。使用 Mock 路由，前端、客户端和测试人员无需等待真实后端服务即可开展接口联调与功能验证，也无需额外部署临时 Mock 服务，有助于减少前后端依赖并缩短联调周期。

前提条件

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

使用限制

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

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

操作步骤

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

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

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

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

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

配置项	说明
路由名称	自定义路由名称。同一服务下路由名称唯一。
所属服务	配置路由所属服务。支持多选，允许快速创建多条路由。
使用场景	选择路由的执行场景。本实例选择 Mock，表示配置 Mock 路由。说明仅在服务配置页面中，为该服务创建单条路由时支持选择使用场景。
匹配规则	配置匹配规则，只有符合规则的请求才能转发至目标 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，与创建时间无关。

Mock 配置

请求匹配 Mock 路由规则后，网关将直接返回预先配置的状态码和响应内容。

说明

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

配置项	说明
响应状态码	配置响应状态码，取值范围为 100 ~ 599。
响应体	配置响应体，请勿填写密钥、Token、个人敏感信息等敏感内容。输入类型为字符串形式，例如，Success，{"code":0,"message":"success"}等。

高级配置

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

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

路径匹配示例

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

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

结果验证

验证示例

创建 Mock 路由后，在终端访问服务域名和路由路径，验证 API 网关是否返回预先配置的状态码和响应体。示例中 Mock 路由响应状态码配置为200，响应体配置为Success。

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

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

预期返回结果如下。实际响应协议和响应头可能因访问环境而异，请以响应状态码和响应体为准。

HTTP/1.1 200 OK
content-length: 7
content-type: text/plain
date: Thu, 08 Oct 2026 07:01:55 GMT
server: istio-envoy

Success

查看配置

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

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

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

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

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

说明

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

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

最近更新时间：2026.10.16 15:59:48

这个页面对您有帮助吗？

有用

无用