huang
b5147d1acb
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 7m34s
58 lines
1.7 KiB
Markdown
58 lines
1.7 KiB
Markdown
# Gateway Retry
|
||
|
||
## Purpose
|
||
|
||
Gateway 请求自动重试机制，在网络级错误时自动重试，提高 Gateway API 调用的可靠性。
|
||
|
||
## ADDED Requirements
|
||
|
||
### Requirement: 网络级错误自动重试
|
||
|
||
系统 SHALL 在 Gateway API 调用遇到网络级错误时自动重试。
|
||
|
||
#### Scenario: 连接失败自动重试
|
||
|
||
- **WHEN** Gateway HTTP 请求因连接失败（TCP 连接拒绝、DNS 解析失败）失败
|
||
- **THEN** 系统自动重试，最多重试 2 次（共 3 次尝试）
|
||
- **AND** 重试间隔使用指数退避（100ms → 300ms）
|
||
|
||
#### Scenario: Client 超时自动重试
|
||
|
||
- **WHEN** Gateway HTTP 请求因 Client 配置的超时时间到期而失败
|
||
- **THEN** 系统自动重试
|
||
- **AND** 用户传入的 Context 未被取消
|
||
|
||
#### Scenario: Gateway 业务错误不重试
|
||
|
||
- **WHEN** Gateway 返回 HTTP 200 但业务状态码 `code != 200`
|
||
- **THEN** 系统不重试，直接返回业务错误
|
||
|
||
#### Scenario: HTTP 状态码错误不重试
|
||
|
||
- **WHEN** Gateway 返回 HTTP 4xx 或 5xx 状态码
|
||
- **THEN** 系统不重试，直接返回错误
|
||
|
||
#### Scenario: 用户 Context 取消不重试
|
||
|
||
- **WHEN** 用户传入的 Context 被取消
|
||
- **THEN** 系统立即停止，不重试
|
||
|
||
#### Scenario: 加密或序列化错误不重试
|
||
|
||
- **WHEN** 请求参数加密或序列化失败
|
||
- **THEN** 系统不重试，直接返回错误
|
||
|
||
### Requirement: 重试配置
|
||
|
||
系统 SHALL 支持通过链式方法配置重试参数。
|
||
|
||
#### Scenario: 自定义最大重试次数
|
||
|
||
- **WHEN** 调用 `client.WithRetry(3)` 后发起 API 请求
|
||
- **THEN** 网络级错误时最多重试 3 次（共 4 次尝试）
|
||
|
||
#### Scenario: 禁用重试
|
||
|
||
- **WHEN** 调用 `client.WithRetry(0)` 后发起 API 请求
|
||
- **THEN** 不进行任何重试
|