如何实现并测试S3CrtRetryConfiguration重试？配置后未触发重试求指导

问题背景 #

我有一个基于Java开发、集成了AWS SDK的Spring Boot应用，项目使用Gradle作为构建工具。

build.gradle依赖 #

dependencies {
    ......
    .........
    implementation 'software.amazon.awssdk.crt:aws-crt:0.24.0'
    implementation 'software.amazon.awssdk:s3-transfer-manager:2.20.119'
}

S3客户端配置代码 #

S3CrtAsyncClientBuilder s3CrtAsyncClientBuilder = S3AsyncClient.crtBuilder()
            .credentialsProvider(creds).region(region);
S3CrtRetryConfiguration s3CrtRetryConfiguration = S3CrtRetryConfiguration.builder()
            .numRetries(s3UploadMaxRetries).build();
s3CrtAsyncClientBuilder.retryConfiguration(s3CrtRetryConfiguration);
S3AsyncClient s3CrtAsyncClient = s3CrtAsyncClientBuilder.build();

问题：使用该客户端上传文件时，本应在出现失败时触发重试，但实际未观察到重试行为。请问是否遗漏了必要的配置项？

排查与解决建议 #

• 确认重试适用的错误类型
  S3 CRT客户端的S3CrtRetryConfiguration仅对底层驱动抛出的错误生效（比如网络超时、连接重置），像权限不足、文件不存在这类业务错误默认不会触发重试。先排查你遇到的失败是否属于可重试范畴。

• 显式配置重试条件
  默认的CRT重试策略可能只覆盖部分错误码，你可以通过retryCondition指定需要重试的错误集：

  S3CrtRetryConfiguration retryConfig = S3CrtRetryConfiguration.builder()
          .numRetries(s3UploadMaxRetries)
          .retryCondition(S3CrtRetryCondition.defaultRetryCondition()) // 启用默认可重试错误
          // 也可自定义条件，比如添加特定状态码
          // .retryCondition(exception -> {
          //     if (exception instanceof S3Exception s3Ex) {
          //         return List.of("500", "503", "409").contains(s3Ex.statusCodeAsString());
          //     }
          //     return S3CrtRetryCondition.defaultRetryCondition().test(exception);
          // })
          .build();
  

• 检查Transfer Manager的独立配置
  如果是通过S3 Transfer Manager执行上传，注意它有自己的重试配置，优先级高于底层S3AsyncClient的设置，需要单独配置：

  S3TransferManager transferManager = S3TransferManager.builder()
          .s3Client(s3CrtAsyncClient)
          .uploadConfiguration(uploadConfig -> 
              uploadConfig.maxAttempts(s3UploadMaxRetries) // 为Transfer Manager设置重试次数
          )
          .build();
  

• 开启CRT日志验证
  开启DEBUG级别日志，确认错误是否被捕获、重试逻辑是否触发：

  logging:
    level:
      software.amazon.awssdk.crt: DEBUG
      software.amazon.awssdk.services.s3: DEBUG
  

  通过日志可以排查：错误是否匹配重试条件、重试次数是否正确执行。

• 验证版本兼容性
  当前使用的aws-crt:0.24.0和s3-transfer-manager:2.20.119可能存在版本兼容问题，建议同步升级到较新的兼容版本（比如CRT升级到0.25.x系列，SDK对应到2.21.x版本），避免版本不匹配导致配置失效。

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