Quartz多线程处理CSV文件时文件占用导致移动失败

你遇到的这个错误，核心原因是Quartz的5个并行线程同时争抢同一个CSV文件——哪怕单个线程用了try-with-resources释放流，也挡不住其他线程同时尝试打开同一文件。下面是几个能落地的解决方案：

1. 用原子重命名给文件加“处理锁” #

这是最直接有效的办法：扫描到文件后，先尝试给文件加个临时后缀（比如.processing），只有重命名成功的线程才能处理这个文件，其他线程直接跳过。重命名是操作系统级的原子操作，能保证同一时间只有一个线程拿到文件的处理权。

示例代码：

File csvFile = new File("/target/dir/example.csv");
File processingFile = new File("/target/dir/example.csv.processing");

// 原子性抢占文件，成功才继续
if (csvFile.renameTo(processingFile)) {
    try (FileReader reader = new FileReader(processingFile)) {
        // 这里写你的CSV处理逻辑
        processCsv(reader);
        
        // 处理完移去processed文件夹
        File finalFile = new File("/target/dir/processed/example.csv");
        processingFile.renameTo(finalFile);
    } catch (IOException e) {
        // 处理失败，把文件改回原名称，避免永久标记
        processingFile.renameTo(csvFile);
        e.printStackTrace();
    }
} else {
    // 重命名失败，说明文件已经被其他线程拿走了，直接跳过
    return;
}

2. 拆分扫描与处理逻辑，避免并发扫描 #

不要让每个Quartz线程都去扫原始目录，改成单线程扫目录，多线程处理文件：

• 用一个单独的线程定时扫描目录，把未处理的文件加入一个线程安全的队列（比如LinkedBlockingQueue）
• Quartz的5个工作线程从队列里取文件处理，这样就不会出现多个线程抢同一个文件的情况

3. 检查第三方CSV库的资源释放 #

如果你用了Apache Commons CSV、OpenCSV这类第三方库处理文件，要确保所有涉及文件流的对象都被正确关闭。比如把CSV解析器也放进try-with-resources里：

try (FileReader reader = new FileReader(processingFile);
     CSVParser parser = CSVParser.parse(reader, CSVFormat.DEFAULT)) {
    // 迭代处理CSV行
    for (CSVRecord record : parser) {
        // 处理逻辑
    }
} catch (IOException e) {
    // 异常处理
}

有些库内部会持有流的引用，单独关闭FileReader可能不够，必须把解析器也纳入自动资源管理。

4. 调整Quartz任务的并发策略 #

如果你的任务是定时重复触发的，可能前一轮的线程还没处理完，下一轮任务又开始扫描了：

• 如果不需要多实例并发，给任务类加@DisallowConcurrentExecution注解（Java Quartz），禁止同一任务的多个实例同时跑，但这会牺牲并行性，适合单个文件处理耗时较长的场景
• 或者拉长触发间隔，确保上一轮所有线程都处理完后，再触发下一次扫描

5. 排除外部进程占用 #

有时候问题不是出在自己代码里——杀毒软件、Windows搜索索引、其他后台程序都可能临时占用文件。可以临时关闭这类程序测试，或者在处理前先检查文件是否可访问：

private boolean canAccessFile(File file) {
    try (RandomAccessFile raf = new RandomAccessFile(file, "r")) {
        return true;
    } catch (Exception e) {
        return false;
    }
}

只有返回true时，才尝试处理这个文件。

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