文档中心

API 网关

路由策略

配置重试策略

API 网关支持为路由配置重试策略，您可以指定重试条件，对出错的请求进行自动重试。例如：与后端服务连接失败、或使用指定的 HTTP 状态码进行请求重试。

背景信息

API 网关允许为不同协议配置重试条件，具体条件和说明，如下表所示。

协议	重置条件	条件说明
HTTP	5xx	后端服务返回5xx状态码，或发生连接断开、重置、读取超时事件。
		reset	发生连接断开、重置、读取超时事件。
		connect-failure	与后端服务连接失败，请求出错。
		refused-stream	后端服务使用REFUSED_STREAM错误码来重置流。
		retriable-status-codes	后端服务返回的 HTTP 状态码匹配上用户指定的重试状态码。
gRPC	cancelled	后端服务响应头中的 gRPC 状态码为cancelled。
		deadline-exceeded	后端服务响应头中的 gRPC 状态码为deadline-exceeded。
		internal	后端服务响应头中的 gRPC 状态码为internal。
		resource-exhausted	后端服务响应头中的 gRPC 状态码为resource-exhausted。
		unavailable	后端服务响应头中的 gRPC 状态码为unavailable。

前提条件

已创建路由，详情可参见创建路由。

操作步骤

配置项	说明
指定场景	配置重试条件或状态码：重试条件：在下拉菜单中选择系统预置的重试条件，分别支持 HTTP 协议和 gRPC 协议的重试条件。详情请参见背景信息。状态码：配置需要进行重试的 HTTP 状态码，例如配置为403状态码。说明重试条件和状态码为或关系，即访问请求命中其中一项，即会对请求进行自动重试。
请求重试	配置请求重试的次数和单次重试的时间。其中：请求重试：整数形式，取值范围为 0～10。单次重试：单位为秒（s），取值范围为 0.01～10000，不包括 10000。

结果验证

配置完成后，您可以使用 API 网关访问后端服务，当访问请求满足重试条件或状态码时，系统会根据配置自动进行重试。

最近更新时间：2025.03.10 17:43:19

这个页面对您有帮助吗？

有用

无用