通过AWS API操作Minio遇STS API版本不兼容错误如何解决？

问题核心 #

你遇到的错误是因为AWS Java SDK的IAM客户端默认硬编码使用STS API版本2010-05-08，但Minio要求的版本是2011-06-15，且SDK内置的CreatePolicyRequestMarshaller无法直接修改该版本参数。

解决方案 #

方案一：改用Minio官方SDK（推荐） #

Minio提供了专属的Java SDK，完全适配自身特性，不存在AWS API版本兼容问题，同时能更好地支持Minio的权限管理逻辑。

1. 引入依赖（以Maven为例）：

<dependency>
    <groupId>io.minio</groupId>
    <artifactId>minio</artifactId>
    <version>8.5.7</version> <!-- 建议使用最新稳定版 -->
</dependency>

2. 修正策略并创建权限：
   注意：Minio兼容的S3 API中没有s3:DeleteItem/s3:GetItem这类动作，需替换为标准S3动作名：

// 初始化Minio客户端
MinioClient minioClient = MinioClient.builder()
        .endpoint("http://your-minio-endpoint:9000")
        .credentials("minio", "minio123")
        .build();

// 修正后的策略文档
String policyDocument = "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":[\"s3:DeleteObject\",\"s3:GetObject\",\"s3:PutObject\"],\"Resource\":\"*\"}]}";

// 为存储桶设置策略（若要创建用户级策略，可使用Minio的IAM相关API）
minioClient.setBucketPolicy("bucket1", policyDocument);

方案二：通过AWS SDK请求拦截器修改API版本 #

如果必须继续使用AWS SDK，可以自定义请求拦截器，在请求发送前替换版本参数：

// 定义请求拦截器，替换STS API版本
SdkRequestInterceptor apiVersionInterceptor = new SdkRequestInterceptor() {
    @Override
    public void modifyRequest(Context.ModifyRequest context) {
        context.request().putParameter("Version", "2011-06-15");
    }
};

// 构建IAM客户端时添加拦截器
IamAsyncClient iam = IamAsyncClient.builder()
        .httpClient(sdkAsyncHttpClient)
        .region(Region.of(myProperties.getRegion()))
        .credentialsProvider(awsCredentialsProvider)
        .endpointOverride(URI.create(myProperties.getEndpoint()))
        .overrideConfiguration(config -> config.addInterceptor(apiVersionInterceptor))
        .build();

方案三：升级AWS SDK版本 #

尝试将AWS SDK升级到最新稳定版，部分新版本可能已经针对Minio的兼容性做了优化，自动适配所需的STS API版本。

额外注意点 #

你当前的策略文档中使用了错误的S3动作名，即使版本问题解决，这些动作也会无效，必须将s3:DeleteItem/s3:GetItem/s3:PutItem/s3:UpdateItem替换为标准的s3:DeleteObject/s3:GetObject/s3:PutObject。

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