在Spring File Storage项目中实现递归删除MinIO文件夹及文件

背景介绍

Spring File Storage是一个优秀的文件存储管理框架，它简化了与各种存储平台（如MinIO）的集成操作。在实际应用中，我们经常需要清理临时文件夹及其内容，这涉及到递归删除操作。

MinIO存储结构特点

MinIO作为一种对象存储服务，其内部实际上并没有传统文件系统中的"文件夹"概念。所谓的"文件夹"是通过对象键名中的"/"字符模拟出来的。例如，"tmp/file.txt"这个对象键名会被展示为tmp文件夹下的file.txt文件。

递归删除实现方案

在Spring File Storage项目中，可以通过获取MinioClient实例来实现递归删除功能。以下是具体实现代码：

/**
 * 删除临时文件 每天夜里3点执行
 */
@Scheduled(cron = "0 0 3 * * ?")
public void deleteTempFile() {
    MinioFileStorage minioFileStorage = fileStorageService.getFileStorage();
    String bucketName = minioFileStorage.getBucketName();
    MinioClient minioClient = minioFileStorage.getClient();
    cleanTemporaryDir(TEMP, bucketName, minioClient);
}

/**
 * 递归删除临时文件
 *
 * @param dir 要删除的目录路径
 * @param bucketName MinIO存储桶名称
 * @param minioClient MinIO客户端实例
 */
public void cleanTemporaryDir(String dir, String bucketName, MinioClient minioClient) {
    if (StringUtils.isBlank(dir) || "/".equals(dir)) {
        throw new IllegalArgumentException("非法的删除目录！");
    }
    try {
        // 列出指定前缀的所有对象
        Iterable<Result<Item>> list = minioClient.listObjects(ListObjectsArgs.builder()
                .bucket(bucketName)
                .prefix(dir)
                .recursive(false)
                .build());
        
        // 遍历处理每个对象
        for (Result<Item> itemResult : list) {
            Item item = itemResult.get();
            String fileName = item.objectName();
            if (item.isDir()) {
                // 如果是目录则递归处理
                cleanTemporaryDir(fileName, bucketName, minioClient);
            } else {
                // 如果是文件则直接删除
                minioClient.removeObject(RemoveObjectArgs.builder()
                        .bucket(bucketName)
                        .object(fileName)
                        .build());
            }
        }
    } catch (Exception e) {
        throw new RuntimeException("删除临时文件失败: " + e.getMessage());
    }
}

技术要点解析

1. 定时任务配置：使用Spring的@Scheduled注解配置每天凌晨3点执行清理任务，确保不影响业务高峰期性能。

2. 安全校验：对目录参数进行校验，防止误删根目录等危险操作。

3. 递归处理：通过listObjects方法获取目录内容，区分文件和目录进行不同处理。

4. 异常处理：捕获并转换MinIO操作可能抛出的异常。

替代方案建议

项目协作者提出了更优的解决方案：如果这些文件都是通过系统上传的，可以将上传记录保存到数据库。这样做有以下优势：

1. 删除操作不依赖存储平台特性，更具通用性
2. 可以基于业务逻辑进行更精细的控制
3. 便于实现软删除、回收站等功能
4. 可以记录操作日志，满足审计需求

最佳实践

1. 对于临时文件清理，建议结合业务场景设置合理的保留期限
2. 执行批量删除操作时，应考虑添加适当的延迟，避免对存储服务造成过大压力
3. 重要数据删除前建议实现二次确认机制
4. 生产环境建议添加操作日志记录功能

通过Spring File Storage框架与MinIO的深度集成，开发者可以灵活实现各种文件管理需求，包括复杂的递归删除操作。这种方案既保持了框架的简洁性，又能满足实际业务场景中的复杂需求。