重试机制

更新时间:

V2.0 SDK中,OpenAPI请求处理逻辑内置了网络异常的自动重试机制。当请求因网络问题失败时,系统会自动重新尝试,以提升服务的稳定性和可靠性。但对于由业务逻辑引发的错误(如参数错误、资源不存在等),SDK不会进行重试。这类错误通常需要应用程序根据具体的错误信息进行针对性处理或调整,而非简单重复请求 。本文将为您介绍V2.0 SDK对于网络异常的自动重试机制的配置方式。

重试机制配置方式

说明

重试机制配置优先级为:RuntimeOptions配置->默认配置,优先级依次降低。

  • 使用默认配置。默认不会进行重试,如果打开重试配置,且未配置重试次数,则默认最多重试3次。

  • 通过运行时参数(RuntimeOptions)配置。

    use AlibabaCloud\Tea\Utils\Utils\RuntimeOptions;
    
    // 运行时参数设置,仅对使用了该运行时参数实例的请求有效
    $runtime = new RuntimeOptions([
        "autoretry" => true, // 重试配置开关
        "maxAttempts" => 3, // 重试次数
    ]);