AWS Java SDK v2中ResponseHeaderOverrides类找不到的编译错误

算力阿峰

2026-6-22

解决AWS Java SDK v2中找不到ResponseHeaderOverrides的问题

你的问题核心是视频教程用的是AWS SDK v1的代码写法，但你项目里引入的是v2版本，两个版本的API结构差异极大，直接导致类找不到的编译错误。以下是具体修复步骤：

1. 修正导入路径

SDK v2中，ResponseHeaderOverrides是GetObjectRequest的静态内部类，原导入路径完全错误，需要改成：

import software.amazon.awssdk.services.s3.model.GetObjectRequest.ResponseHeaderOverrides;

2. 改用SDK v2的Builder模式重写代码

v2彻底抛弃了v1的withXXX()链式调用风格，统一使用Builder模式构建请求。修正后的完整代码如下：

// get object 
public static void getObject(S3Client s3Client, String bucketName, String key) {
    System.out.println("Checking if bucket exists. Bucket Name: " + bucketName);
    System.out.printf("%n");
    try {
        // 构建响应头覆盖配置
        GetObjectRequest.ResponseHeaderOverrides headerOverrides = GetObjectRequest.ResponseHeaderOverrides.builder()
                .cacheControl("No-cache")
                .contentDisposition("attachment; filename=key.txt")
                .build();

        // 构建GetObjectRequest请求
        GetObjectRequest getObjectRequest = GetObjectRequest.builder()
                .bucket(bucketName)
                .key(key)
                .responseHeaders(headerOverrides)
                .build();

        // 获取对象并处理流
        ResponseInputStream<GetObjectResponse> headerOverrideObject = s3Client.getObject(getObjectRequest);
        displayTextInputStream(headerOverrideObject);
    } catch (S3Exception e) {
        System.err.println(e.awsErrorDetails().errorMessage());
    }        
}