文档导航

接口:RetryPolicy

接口:RetryPolicy

重试配置。部分覆盖时,未设置的字段继承自客户端或 SDK 的默认值。

属性

apiConnectionError

readonly apiConnectionError: boolean;

是否重试连接失败,包括响应体被中断的情况(APIConnectionError)。默认:true。


apiTimeoutError

readonly apiTimeoutError: boolean;

是否重试 APITimeoutError。默认:true。


backoffInitialMs

readonly backoffInitialMs: number;

首次退避延迟,单位为毫秒,每次翻倍,直到 backoffMaxMs。默认:500。


backoffJitter

readonly backoffJitter: number;

从每次退避延迟中随机减去的比例,取值 0 到 1。默认:0.25。


backoffMaxMs

readonly backoffMaxMs: number;

最大退避延迟,单位为毫秒。默认:5000。


httpStatuses

readonly httpStatuses: ReadonlySet<number>;

要重试的 HTTP 状态码。默认:408、429,以及 500–599。


maxRetries

readonly maxRetries: number;

首次尝试之后的最大重试次数;0 表示禁用重试。默认:2。


maxRetryAfterMs

readonly maxRetryAfterMs: number;

服务器要求的最大重试延迟,单位为毫秒;更长的延迟改用退避。默认:60000。


respectRetryAfter

readonly respectRetryAfter: boolean;

是否遵循 Retry-After 和 retry-after-ms,上限为 maxRetryAfterMs。默认:true。