用途:该技能帮助以生产安全的默认值搭建 AWS SDK for Java 2.x 客户端,重点处理凭证与区域解析、同步与异步 HTTP 客户端配置、超时、重试、生命周期管理与测试。
主要能力:选择服务客户端类型(同步 S3Client、DynamoDbClient 用于请求/响应流程;异步 S3AsyncClient、SqsAsyncClient 用于并发、流式或背压场景),按服务与配置复用同一客户端;使用 DefaultCredentialsProvider 并结合本地开发、CI/CD、AWS 运行时(ECS 任务角色、EKS IRSA、EC2 实例配置文件)等环境感知默认值;仅在多账号、测试隔离或切换 profile 时覆盖;通过 StsClient.getCallerIdentity() 在启动时确认凭证解析。
配置要点:显式设置 API 调用超时与单次尝试超时、连接超时、最大连接数或并发数,并按服务配额与幂等性调整重试策略;同步客户端用 ApacheHttpClient,异步用 NettyNioAsyncHttpClient。Spring Boot 中应将客户端以 @Bean 单例暴露、构造器注入,凭证与区域放在配置文件中,避免在热路径内创建客户端。
失败处理与测试:在集成边界捕获 SdkException 或服务特定异常,区分可重试失败与认证、配额、校验失败,记录请求上下文但不记录密钥;发布前用 LocalStack、Testcontainers 或沙箱账号运行集成测试,并可用 @PostConstruct 在启动时快速失败。
示例(保持原样):
StsClient stsClient = StsClient.builder().build(); GetCallerIdentityResponse identity = stsClient.getCallerIdentity();
@Bean S3Client s3Client() { return S3Client.builder() .region(Region.of("eu-south-2")) .credentialsProvider(DefaultCredentialsProvider.create()) .httpClientBuilder(ApacheHttpClient.builder() .maxConnections(100) .connectionTimeout(Duration.ofSeconds(3))) .overrideConfiguration(ClientOverrideConfiguration.builder() .apiCallAttemptTimeout(Duration.ofSeconds(10)) .apiCallTimeout(Duration.ofSeconds(30)) .build()) .build(); }
SqsAsyncClient sqsAsyncClient = SqsAsyncClient.builder() .region(Region.US_EAST_1) .credentialsProvider(DefaultCredentialsProvider.create()) .httpClientBuilder(NettyNioAsyncHttpClient.builder() .maxConcurrency(200) .connectionTimeout(Duration.ofSeconds(3)) .readTimeout(Duration.ofSeconds(20))) .overrideConfiguration(ClientOverrideConfiguration.builder() .apiCallTimeout(Duration.ofSeconds(30)) .build()) .build();
限制与警告:不要在源码、示例或配置中嵌入访问密钥或会话令牌,静态凭证仅可用于范围受限的本地测试;缺失区域或凭证解析错误常在首次调用时才失败,需显式验证启动假设;异步客户端需管理底层 HTTP 资源生命周期;过度重试会放大限流并增加延迟;代理、TLS 与指标发布 API 因所选 HTTP 栈和 SDK 版本而异,需按项目实际版本调整示例。