Vaadin上传组件临时文件清理：Spring Boot场景下解决方案咨询

针对你遇到的临时文件残留问题，提供三种针对性的实现方案：

一、Spring Boot启动时清理所有临时文件 #

通过Spring的启动回调事件，在应用实例启动完成后直接清空指定临时目录：

import org.springframework.boot.context.event.ApplicationReadyEvent;
import org.springframework.context.ApplicationListener;
import org.springframework.stereotype.Component;
import java.io.File;

@Component
public class StartupTempCleaner implements ApplicationListener<ApplicationReadyEvent> {

    // 替换为你的Vaadin上传临时目录路径
    private static final String TEMP_DIR = "/your/vaadin/temp/dir";

    @Override
    public void onApplicationEvent(ApplicationReadyEvent event) {
        File tempDirectory = new File(TEMP_DIR);
        if (tempDirectory.exists() && tempDirectory.isDirectory()) {
            File[] tempFiles = tempDirectory.listFiles();
            if (tempFiles != null) {
                for (File file : tempFiles) {
                    // 强制删除文件（若文件被占用会失败，可添加日志记录）
                    file.delete();
                }
            }
        }
    }
}

二、Vaadin会话销毁时清理当前会话的临时文件 #

核心思路是：用户上传文件时，将文件路径绑定到当前Vaadin会话；会话销毁时（用户离开页面、超时），自动清理该会话关联的所有文件。

1. 上传时绑定文件到会话

// 自定义上传接收器，记录文件存储路径
class CustomFileReceiver implements Receiver {
    private String savedFilePath;

    @Override
    public OutputStream receiveUpload(String filename, String mimeType) {
        File file = new File("/your/vaadin/temp/dir", filename);
        this.savedFilePath = file.getAbsolutePath();
        try {
            return new FileOutputStream(file);
        } catch (FileNotFoundException e) {
            throw new RuntimeException(e);
        }
    }

    public String getSavedFilePath() {
        return savedFilePath;
    }
}

// 初始化上传组件时关联会话
Upload upload = new Upload(new CustomFileReceiver());
upload.addSucceededListener(event -> {
    CustomFileReceiver receiver = (CustomFileReceiver) upload.getReceiver();
    // 把当前会话的上传文件存入会话属性（多文件可改用List<String>）
    VaadinSession.getCurrent().setAttribute("sessionUploadFiles", receiver.getSavedFilePath());
});

2. 监听会话销毁事件清理文件

import com.vaadin.flow.server.ServiceInitEvent;
import com.vaadin.flow.server.VaadinServiceInitListener;
import org.springframework.stereotype.Component;
import java.io.File;

@Component
public class SessionTempCleaner implements VaadinServiceInitListener {

    @Override
    public void serviceInit(ServiceInitEvent event) {
        event.getSource().addSessionDestroyListener(destroyEvent -> {
            // 获取当前会话绑定的文件路径
            String filePath = destroyEvent.getSession().getAttribute("sessionUploadFiles");
            if (filePath != null) {
                new File(filePath).delete();
            }
            // 多文件场景：
            // List<String> filePaths = destroyEvent.getSession().getAttribute("sessionUploadFiles");
            // if (filePaths != null) {
            //     filePaths.forEach(path -> new File(path).delete());
            // }
        });
    }
}

三、定期清理过期临时文件 #

针对会话销毁未触发的极端场景（比如用户强制关闭浏览器），用Spring定时任务定期清理超过指定时长的临时文件：

import org.springframework.scheduling.annotation.Scheduled;
import org.springframework.stereotype.Component;
import java.io.File;
import java.time.Instant;
import java.time.temporal.ChronoUnit;

@Component
public class ScheduledTempCleaner {

    private static final String TEMP_DIR = "/your/vaadin/temp/dir";
    // 清理24小时前创建的文件
    private static final long EXPIRY_HOURS = 24;

    // 每小时执行一次清理
    @Scheduled(fixedRate = 3600000)
    public void cleanExpiredFiles() {
        File tempDirectory = new File(TEMP_DIR);
        if (!tempDirectory.exists()) return;

        File[] files = tempDirectory.listFiles();
        if (files == null) return;

        Instant cutoffTime = Instant.now().minus(EXPIRY_HOURS, ChronoUnit.HOURS);
        for (File file : files) {
            Instant fileCreateTime = Instant.ofEpochMilli(file.lastModified());
            if (fileCreateTime.isBefore(cutoffTime)) {
                file.delete();
            }
        }
    }
}

注意：需要在Spring Boot主类上添加@EnableScheduling注解开启定时任务功能。

额外提示 #

• 确保应用对临时目录有读写删除权限；
• 若担心清理正在处理的文件，可在文件命名时添加状态标识（比如处理完成后重命名为xxx_done），清理时只删除未标记的文件；
• Vaadin 14+默认使用系统临时目录，可通过Upload.setReceiver自定义存储路径，更便于会话关联和清理。

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