如何为AWS SDK for Java 2.x配置含roleSessionName与roleArn的STSAssumeRoleSessionCredentialsProvider

核心适配对照 #

2.x版本SDK对客户端构建、凭证管理做了重构，以下配置可完全复现1.x版本中实现的跨角色S3客户端初始化逻辑，无功能差异：

• 原1.x中的STSAssumeRoleSessionCredentialsProvider，在2.x中对应AssumeRoleCredentialsProvider，默认会复用和1.x一致的全局凭证链获取调用AssumeRole接口的基础凭证，自动管理底层STS客户端生命周期
• 原1.x的AmazonS3Client具体类，在2.x中对应同步接口S3Client，能力覆盖完全对等
• 原配置中指定的destroyMethod = "shutdown"逻辑，在2.x中可自动生效：S3Client实现了自动关闭接口，Spring容器销毁Bean时会自动调用其资源回收方法完成连接、线程池释放，无需手动配置

等效配置代码 #

@Configuration
@ImportResource("classpath:aws-context.xml")
public class AmazonS3Config {

    @Bean
    public S3Client amazonS3Client(@Value("${aws.s3.roleSessionName}") String roleSessionName,
                                    @Value("${aws.s3.roleArn}") String role) {
        // 构建跨角色凭证提供者，参数与原1.x实现完全匹配
        AssumeRoleCredentialsProvider credentialsProvider = AssumeRoleCredentialsProvider.builder()
                .roleArn(role)
                .roleSessionName(roleSessionName)
                .build();

        // 构建S3客户端，区域配置与原实现保持一致
        return S3Client.builder()
                .region(Region.US_EAST_1)
                .credentialsProvider(credentialsProvider)
                .build();
    }
}

常见注意事项 #

• 项目需额外引入2.x SDK的STS服务模块依赖，仅引入S3模块会导致跨角色凭证类加载失败
• 若需自定义STS接口的超时、端点、基础凭证源，可在AssumeRoleCredentialsProvider构建时传入自定义配置的STS客户端，自定义能力与1.x版本完全对齐
• 原代码中对AmazonS3Client的强制类型转换逻辑可直接移除，统一使用S3Client接口类型即可

内容的提问来源于stack exchange，提问作者Udit R M