## 前言

在前面的文章中，我们介绍了文件的上传、预览以及文件夹的模拟创建。本文将继续深入，探讨以下三个核心话题：
1.  **定制化下载**：如何生成带有特定响应头（如文件名、缓存策略）的下载链接。
2.  **对象删除**：包括单文件删除、批量删除以及模拟文件夹的删除。
3.  **碎片清理**：如何清理未完成的分片上传任务，释放存储空间。

## 一、定制化下载

虽然我们在上一篇文章中提到了通过预签名 URL 进行下载，但在实际业务中，我们往往需要更精细的控制，比如：
*   **强制浏览器下载**而不是直接打开（例如图片、PDF）。
*   **自定义下载文件名**，并解决中文乱码问题。
*   **设置浏览器缓存策略**，减少重复请求。

### 代码实现

我们可以使用 `ResponseHeaderOverrides` 类来覆盖 COS 返回的 HTTP 响应头。

```java
@Service
public class CosDownloadService {

    @Autowired
    private COSClient cosClient;

    @Value("${tencent.cos.bucket-name}")
    private String bucketName;

    /**
     * 生成定制化的下载链接
     * 
     * @param key 文件在 COS 中的路径
     * @param downloadFileName 下载时显示的文件名
     * @return 预签名下载 URL
     */
    public String getDownloadUrl(String key, String downloadFileName) {
        // 1. 创建生成预签名 URL 的请求
        GeneratePresignedUrlRequest req = new GeneratePresignedUrlRequest(bucketName, key, HttpMethodName.GET);
        
        // 2. 设置 URL 过期时间 (例如 30 分钟)
        Date expirationDate = new Date(System.currentTimeMillis() + 30 * 60 * 1000);
        req.setExpiration(expirationDate);

        // 3. 设置响应头覆盖 (ResponseHeaderOverrides)
        ResponseHeaderOverrides responseHeaders = new ResponseHeaderOverrides();
        
        // 3.1 强制下载并设置文件名 (解决中文乱码)
        try {
            String encodedFileName = java.net.URLEncoder.encode(downloadFileName, "UTF-8").replace("+", "%20");
            responseHeaders.setContentDisposition("attachment; filename=\"" + encodedFileName + "\"");
        } catch (UnsupportedEncodingException e) {
            // 兜底方案
            responseHeaders.setContentDisposition("attachment; filename=\"file\"");
        }

        // 3.2 设置缓存策略 (例如缓存 24 小时)
        // Cache-Control: no-cache 表示需协商验证，max-age 表示缓存时间
        // 这里示例设置为 24 小时
        responseHeaders.setCacheControl("max-age=86400");
        responseHeaders.setExpires(DateUtils.formatRFC822Date(new Date(System.currentTimeMillis() + 24 * 3600 * 1000)));

        // 3.3 设置内容语言 (可选)
        responseHeaders.setContentLanguage("zh-CN");

        // 将覆盖配置应用到请求中
        req.setResponseHeaders(responseHeaders);

        // 4. 生成 URL
        URL url = cosClient.generatePresignedUrl(req);
        return url.toString();
    }
}
```

## 二、对象删除

### 1. 删除单个文件

删除单个文件非常简单，直接调用 `deleteObject` 即可。

```java
    /**
     * 删除单个文件
     */
    public void deleteFile(String key) {
        try {
            cosClient.deleteObject(bucketName, key);
        } catch (Exception e) {
            log.error("删除文件失败: {}", key, e);
            throw new RuntimeException("删除文件失败");
        }
    }
```

### 2. 批量删除文件

如果需要删除多个文件，循环调用 `deleteObject` 效率较低。COS 提供了 `deleteObjects` 接口进行批量删除。

```java
    /**
     * 批量删除文件
     * @param keys 文件路径列表
     */
    public void deleteBatch(List<String> keys) {
        DeleteObjectsRequest deleteObjectsRequest = new DeleteObjectsRequest(bucketName);
        List<DeleteObjectsRequest.KeyVersion> keyVersions = new ArrayList<>();
        
        for (String key : keys) {
            keyVersions.add(new DeleteObjectsRequest.KeyVersion(key));
        }
        
        deleteObjectsRequest.setKeys(keyVersions);

        try {
            DeleteObjectsResult deleteObjectsResult = cosClient.deleteObjects(deleteObjectsRequest);
            List<DeleteObjectsResult.DeletedObject> deletedObjects = deleteObjectsResult.getDeletedObjects();
            log.info("成功批量删除 {} 个文件", deletedObjects.size());
        } catch (MultiObjectDeleteException mde) {
            // 部分删除失败的处理
            List<DeleteObjectsResult.DeletedObject> deletedObjects = mde.getDeletedObjects();
            List<MultiObjectDeleteException.DeleteError> errors = mde.getErrors();
            log.warn("批量删除部分失败，成功: {}, 失败: {}", deletedObjects.size(), errors.size());
        }
    }
```

### 3. 删除文件夹

正如之前文章所述，COS 没有真正的文件夹。要删除一个“文件夹”，必须删除该前缀下的所有对象。

```java
    /**
     * 删除文件夹（递归删除该前缀下的所有文件）
     */
    public void deleteFolder(String folderPath) {
        if (!folderPath.endsWith("/")) {
            folderPath += "/";
        }åç

        ListObjectsRequest listObjectsRequest = new ListObjectsRequest();
        listObjectsRequest.setBucketName(bucketName);
        listObjectsRequest.setPrefix(folderPath);
        
        ObjectListing objectListing = null;
        
        do {
            objectListing = cosClient.listObjects(listObjectsRequest);
            List<COSObjectSummary> cosObjectSummaries = objectListing.getObjectSummaries();
            
            if (cosObjectSummaries.isEmpty()) {
                break;
            }

            List<String> keysToDelete = cosObjectSummaries.stream()
                .map(COSObjectSummary::getKey)
                .collect(Collectors.toList());
            
            // 批量删除当前页的文件
            deleteBatch(keysToDelete);
            
            // 标记下一页
            listObjectsRequest.setMarker(objectListing.getNextMarker());
            
        } while (objectListing.isTruncated()); // 如果还有下一页，继续循环
    }
```

## 三、碎片清理（Abort Multipart Upload）

在断点续传或大文件分片上传过程中，如果上传中断且长时间未恢复，这些已上传的**分片（Parts）**会一直占用存储空间，产生费用，但在文件列表中却不可见。

我们需要定期清理这些“幽灵”碎片。

### 代码实现

```java
    /**
     * 清理所有未完成的分片上传任务 (碎片清理)
     * 建议通过定时任务(Scheduled)定期执行
     */
    public void cleanUpFragments() {
        ListMultipartUploadsRequest listMultipartUploadsRequest = new ListMultipartUploadsRequest(bucketName);
        // 每次最多列出 100 个未完成的任务
        listMultipartUploadsRequest.setMaxUploads(100);
        
        MultipartUploadListing multipartUploadListing = null;
        
        do {
            // 1. 列出未完成的分片上传任务
            multipartUploadListing = cosClient.listMultipartUploads(listMultipartUploadsRequest);
            List<MultipartUpload> multipartUploads = multipartUploadListing.getMultipartUploads();
            
            for (MultipartUpload mUpload : multipartUploads) {
                String key = mUpload.getKey();
                String uploadId = mUpload.getUploadId();
                
                // 可以在这里添加过滤逻辑，例如只清理 7 天前的任务
                // Date initiated = mUpload.getInitiated();
                
                log.info("发现未完成任务，准备清理 -> Key: {}, UploadId: {}", key, uploadId);
                
                // 2. 终止上传任务 (相当于删除已上传的分片)
                AbortMultipartUploadRequest abortRequest = new AbortMultipartUploadRequest(bucketName, key, uploadId);
                try {
                    cosClient.abortMultipartUpload(abortRequest);
                    log.info("清理成功: {}", key);
                } catch (Exception e) {
                    log.error("清理失败: {}", key, e);
                }
            }
        } while (multipartUploadListing.isTruncated());
    }
```

## 四、总结

1.  **下载体验**：通过 `ResponseHeaderOverrides` 可以完美控制下载行为，包括文件名和缓存，提升用户体验。
2.  **批量操作**：删除文件夹本质上是“列出 + 批量删除”的过程。务必注意分页处理（`isTruncated`），防止漏删。
3.  **成本优化**：分片上传的碎片是隐形成本的来源。建议在生产环境中配置**生命周期规则（Lifecycle Rule）**让 COS 自动清理碎片，或者使用代码配合定时任务手动清理。

在前面的文章中，我们介绍了文件的上传、预览以及文件夹的模拟创建。本文将继续深入，探讨以下三个核心话题：

Spring Boot 实战：腾讯云 COS 对象下载、删除与碎片清理

在前面的文章中，我们介绍了文件的上传、预览以及文件夹的模拟创建。本文将继续深入，探讨以下三个核心话题：
1.  定制化下载：如何生成带有特定响应头（如文件名、缓存策略）的下载链接。
2.  对象删除：包括单文件删除、批量删除以及模拟文件夹的删除。
3.  碎片清理：如何清理未完成的分片上传任务，释放存储空间。

前端开发工程师

云计算

后端

开发工具

本文深入探讨腾讯云COS文件管理的三大核心功能：定制化下载（控制响应头、文件名和缓存策略）、对象删除（单文件/批量/文件夹删除）和碎片清理（释放未完成上传的分片空间）。提供Java代码示例，帮助开发者优化文件下载体验、高效管理存储资源并降低隐形成本。

对象存储COS新用户低至1元！


文章

问答

视频

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Spring Boot 实战：腾讯云 COS 对象下载、删除与碎片清理-腾讯云开发者社区-腾讯云

Spring Boot 实战：腾讯云 COS 对象下载、删除与碎片清理

Spring Boot 实战：腾讯云 COS 对象下载、删除与碎片清理

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐