一、功能简介
·Tool 级独立配置：每个 Tool 单独一份重试配置，不做 Server 级 / Route 级继承或降级。
·三类重试条件：支持按“后端 5xx”“连接失败”“请求超时”三种条件触发重试，可任选一项或多项组合。
·幂等安全保护：对 POST / PUT / PATCH 等非幂等方法，必须显式确认后端接口具备幂等性后才允许开启重试，避免重复写入造成数据副作用。
·默认关闭：存量 Tool 和新建 Tool 均默认不启用重试，行为与原先完全一致，按需开启。
注意：说明：
注意：重试仅对 HTTP 转 MCP 服务的 Tool 生效；标准 MCP 服务的 Tool 由后端 MCP Server 自身负责容错，网关不提供重试配置。
二、重试参数说明
| 参数 | 取值范围 | 说明 |
| 启用重试 | 开 / 关 | 重试总开关；关闭时下述配置均不生效 |
| 重试次数 | 1 ~ 5 | 启用重试时必填；非幂等方法建议设为 1 |
| 重试条件 | 5xx / 连接失败 / 请求超时 | 启用重试时至少勾选一项 |
| 已确认后端接口具备幂等性 | 勾选 / 不勾选 | Tool 的 HTTP Method 为 POST/PUT/PATCH 时必须勾选，否则无法保存；GET/HEAD/OPTIONS/DELETE 忽略此项 |
三、三类重试条件的覆盖范围
| 重试条件 | 触发场景 |
| 后端 5xx | 后端返回 500 / 502 / 503 / 504 状态码 |
| 连接失败 | 网关在收到后端首字节响应前的错误，包括 TCP 建连失败、connection refused、DNS 解析失败，以及建连后发送请求 / 读响应头阶段对端 RST |
| 请求超时 | 读写超时 / 上游处理超时 |
四、配置重试
1. 登录 微服务平台控制台 ，左侧导航栏选择 AI 网关进入实例列表；
2. 在实例列表页面，单击需要配置的网关实例的“ID”，进入该网关实例的基本信息页面；
3. 进入目标 MCP Server 的 Tool 列表 / Tool 详情页，找到需要重试的 Tool（其所属 Server 须为 HTTP 转 MCP 服务）；
4. 展开 配置重试策略 折叠面板；
5. 填写 重试次数（1 ~ 5）；
6. 勾选 重试条件（5xx / 连接失败 / 请求超时，至少一项）；
7. 若该 Tool 的 HTTP Method 为 POST / PUT / PATCH，需勾选“已确认后端接口具备幂等性”，否则保存会被拒绝；
8. 单击保存。配置将在下发到数据面并生效。
五、修改与关闭重试
·修改：再次展开该 Tool 的“重试策略”面板，调整参数后保存即可，约 5 秒内生效。
·关闭 / 清除：将“启用重试”总开关关闭并保存，或删除重试配置，该 Tool 恢复为不重试（行为与存量一致）。
·删除该 Tool 时会自动级联清除其重试配置，无需单独操作。