Amazon S3客户端Retry策略配置及RequestRetryMode参数使用指南

一、RequestRetryMode 枚举各取值含义 #

• Legacy(0)：AWS SDK旧版本的默认重试策略，不同编程语言的SDK重试逻辑没有统一规范，指数退避的计算规则各SDK独立实现，跨语言场景下重试行为差异较大。
• Standard(1)：AWS官方跨所有SDK统一标准化的重试策略，内置统一的重试触发条件、指数退避计算规则，对5xx服务端错误、限流错误、网络超时等可重试错误的处理逻辑在所有SDK中完全一致，稳定性和可预期性更高，是官方推荐的生产环境默认选项。
• Adaptive(2)：基于Standard策略迭代的实验性重试策略，保留Standard全部的指数退避逻辑的同时，额外新增客户端侧拥塞控制能力，会根据服务端返回的错误率、限流响应动态调整客户端的请求发送速率，适合高并发大流量场景，避免无效重试导致的请求雪崩。

二、指数退避重试机制实现方式 #

你可以通过在实例化AmazonS3Config时指定RetryMode和MaxErrorRetry两个参数，即可快速启用SDK内置的指数退避重试能力，示例代码如下：

new AmazonS3Config { RetryMode = RequestRetryMode.Standard, MaxErrorRetry = 5 }

相关逻辑说明：

1. 当你将RetryMode设置为Standard或Adaptive时，SDK会自动启用标准化的指数退避逻辑，每次重试的等待间隔按照「基础延迟 * 2^当前重试次数」的规则计算，同时内置最大延迟上限，避免单次等待时间过长。
2. MaxErrorRetry参数用于指定最大重试次数，上述示例中设置为5即代表请求最多重试5次，5次全部失败后才会将错误抛出给上层业务逻辑。
3. 若选择Legacy模式也可实现指数退避，但退避参数没有统一标准，不同版本SDK行为可能存在差异，不推荐生产环境使用。
4. Adaptive模式在指数退避的基础上新增了客户端速率调整逻辑，在服务端出现大面积限流时会自动降低请求发送频率，进一步提升高并发场景下的请求成功率。

内容的提问来源于stack exchange，提问作者datahack