Spring Boot中如何将AWS S3文件下载至客户端默认下载目录？

你的核心问题在于：当前代码是把S3文件下载到服务器本地磁盘（硬编码的D:\rohit\路径），这和客户端的下载文件夹完全无关——用户根本拿不到服务器上的这个文件。要实现用户点击下载后文件自动保存到客户端默认下载目录，核心思路是直接把S3的文件流通过HTTP响应返回给前端浏览器，由浏览器自动处理下载逻辑。

为什么你之前的方案行不通？ #

你查的Stack Overflow链接其实已经点明了关键：出于安全限制，前端JS和后端代码都无法直接指定客户端的本地文件保存路径，只能让浏览器按照默认行为（保存到用户设置的默认下载文件夹）来处理。你的旧代码本质是在服务器端存文件，完全没涉及到给客户端返回文件流，所以自然无法实现需求。

具体解决方案 #

修改你的后端接口，直接将S3文件的输入流通过HTTP响应返回，同时设置正确的响应头触发浏览器的下载行为。下面给出两种SDK版本的实现示例：

方案1：AWS SDK v1（对应你当前的代码环境）

import org.springframework.core.io.InputStreamResource;
import org.springframework.http.HttpHeaders;
import org.springframework.http.MediaType;
import org.springframework.http.ResponseEntity;
import com.amazonaws.services.s3.AmazonS3;
import com.amazonaws.services.s3.model.GetObjectRequest;
import com.amazonaws.services.s3.model.S3Object;

// 这是你的Controller接口方法
public ResponseEntity<InputStreamResource> downloadFileFromS3(String key) throws IOException {
    LOG.info("Start - downloadFileFromS3 for key: {} and bucket name: {}", key, bucketName);
    AmazonS3 s3Client = initAWS(); // 确保initAWS()返回AmazonS3客户端实例
    
    // 直接从S3获取文件输入流，不需要在服务器本地创建文件
    S3Object s3Object = s3Client.getObject(new GetObjectRequest(bucketName, key));
    
    // 设置响应头，告诉浏览器这是需要下载的文件
    HttpHeaders headers = new HttpHeaders();
    headers.add(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename=\"" + key + "\"");
    headers.add(HttpHeaders.CONTENT_TYPE, s3Object.getObjectMetadata().getContentType());
    
    return ResponseEntity.ok()
            .headers(headers)
            .contentLength(s3Object.getObjectMetadata().getContentLength())
            .body(new InputStreamResource(s3Object.getObjectContent()));
}

方案2：AWS SDK v2（如果你计划升级到新版SDK）

import org.springframework.core.io.InputStreamResource;
import org.springframework.http.HttpHeaders;
import org.springframework.http.ResponseEntity;
import software.amazon.awssdk.services.s3.S3Client;
import software.amazon.awssdk.services.s3.model.GetObjectRequest;
import software.amazon.awssdk.core.ResponseInputStream;
import software.amazon.awssdk.services.s3.model.GetObjectResponse;

// Controller接口方法
public ResponseEntity<InputStreamResource> downloadFileFromS3(String key) throws IOException {
    LOG.info("Start - downloadFileFromS3 for key: {} and bucket name: {}", key, bucketName);
    S3Client s3Client = initAWSV2(); // 初始化v2版本的S3客户端
    
    GetObjectRequest request = GetObjectRequest.builder()
            .bucket(bucketName)
            .key(key)
            .build();
    
    ResponseInputStream<GetObjectResponse> s3InputStream = s3Client.getObject(request);
    GetObjectResponse s3Response = s3InputStream.response();
    
    HttpHeaders headers = new HttpHeaders();
    headers.add(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename=\"" + key + "\"");
    headers.add(HttpHeaders.CONTENT_TYPE, s3Response.contentType());
    
    return ResponseEntity.ok()
            .headers(headers)
            .contentLength(s3Response.contentLength())
            .body(new InputStreamResource(s3InputStream));
}

关键说明 #

1. 避免服务器本地存储：直接使用S3的文件输入流返回给客户端，既节省服务器磁盘空间，也彻底解决了路径硬编码的问题。
2. 响应头设置：Content-Disposition: attachment; filename="xxx"是核心——它告诉浏览器要触发下载行为，而不是直接打开文件，同时指定下载后的文件名。
3. 浏览器的作用：用户点击下载链接后，浏览器会自动将文件保存到用户预设的默认下载文件夹，这是浏览器的默认行为，后端无需干预（也无法干预）。

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