Java 异步导出只测最终行数,为什么下载时仍会少一行?

导出两笔订单,读线程第一次打开 orders.csv,只读到第一笔。等导出结束,再打开同一文件,两笔都在。只检查最终文件,很容易让这个实现通过验收。

问题出在下载入口开放得太早。假设它的规则是"只要能打开正式文件名,就把内容交给用户"。后台直接往这个名字里写,第一批数据刷出去,读者就可能拿到半份 CSV。即使日志最后记下"成功导出 2 行",那份已经读走的文件也不会跟着补全。

把第一次读取安排在两行之间

下面是一个本地 Java 实验。文件只有两条数据,A 单 20 元,B 单 30 元。写完 A 就执行 flush(),让缓冲区里的数据写出去。然后请另一个线程打开正式文件名,等它读完、关掉文件后,写线程才继续。这样不用猜机器有多快,也不用靠 sleep 碰时机。

两种写法都测两遍。一遍正常写完,一遍模拟用户在第一行写完后取消任务。读线程始终只读 orders.csv。 第一种直接写这个文件;第二种先写同目录的 orders.part,正常写完并关闭后,再用原子移动把它改成正式文件名。这里的"原子"说的是改名在文件系统里作为一步完成。

复制代码,看四次实际读取

用 JDK 21 把下面代码保存为 ExportVisibility.java,在文件所在目录执行 java ExportVisibility.java 即可。每组数据都在单独的临时目录里生成,程序结束时清理。读取结果中,斜线分隔 CSV 的两行,NO_FILE 表示正式文件名当时还不存在。

java 复制代码
import java.io.IOException;
import java.nio.file.*;
import java.util.concurrent.*;

public class ExportVisibility {
    static String readReport(Path file) throws IOException {
        try {
            return String.join(" / ", Files.readAllLines(file));
        } catch (NoSuchFileException e) {
            return "NO_FILE";
        }
    }

    static void run(boolean staged, boolean cancelled) throws Exception {
        Path dir = Files.createTempDirectory("export-visibility-");
        Path report = dir.resolve("orders.csv");
        Path part = dir.resolve("orders.part");
        String halfway;
        try (var reader = Executors.newSingleThreadExecutor()) {
            try (var out = Files.newBufferedWriter(staged ? part : report)) {
                out.write("A,20\n");
                out.flush();
                // 等读线程用正式文件名读完,再决定是否写第二行。
                halfway = reader.submit(() -> readReport(report)).get();
                if (!cancelled) out.write("B,30\n");
            }
            if (staged && !cancelled) {
                Files.move(part, report, StandardCopyOption.ATOMIC_MOVE);
            }
            String end = readReport(report);
            String mode = staged ? "staged" : "direct";
            String exit = cancelled ? "cancel" : "finish";
            System.out.printf("%s %s | first=%s | end=%s%n", mode, exit, halfway, end);
        } finally {
            Files.deleteIfExists(part);
            Files.deleteIfExists(report);
            Files.delete(dir);
        }
    }

    public static void main(String[] args) throws Exception {
        run(false, false);
        run(true, false);
        run(false, true);
        run(true, true);
    }
}

本机使用 JDK 21.0.11,输出如下。

text 复制代码
direct finish | first=A,20 | end=A,20 / B,30
staged finish | first=NO_FILE | end=A,20 / B,30
direct cancel | first=A,20 | end=A,20
staged cancel | first=NO_FILE | end=NO_FILE

前两行最后读到的文件完全一样,第一次读取却已经把两种实现区分开了。直接写正式文件名时,第一笔订单会提前露出来。先写临时文件时,读线程只能等到生成结束,才能通过正式文件名拿到两笔订单。

我更建议把取消也放进验收。看第三行,只写到 A 就取消,正式路径上仍能读到一份看起来正常的 CSV。第四行里,取消发生在改名前,正式路径从头到尾都读不到文件。示例用主动取消固定这个分支;磁盘故障和进程崩溃要单独测试。

在下载接口里把条件写清楚

如果项目有任务表,可以把"允许下载"放在最后一步:写完、关闭、移动成功后,才把任务标为就绪。下载接口按任务号核对状态,仍在生成或已经取消的任务返回对应状态。这样页面能区分"等一会儿"和"这次任务已经结束",也不用靠猜文件大小判断完成。

示例每个任务都有独立目录,正式文件名开始时不存在。多个任务共用一个文件名,旧报告可能被当成新结果。实际项目可以让输出路径包含任务号,并单独处理"文件移动成功、任务表更新失败"的恢复。跨文件系统或对象存储还得核实各自的发布方式;Java 在不支持原子移动时会抛出 AtomicMoveNotSupportedException,这时应让任务保留可识别的失败状态。JDK 21 的 Files.move 说明

下次测导出,可以把断言提前一次:停在第一批写完的时候,从真实的下载入口读一遍。你的接口此时会告诉用户"还在生成",还是已经把第一批数据发给他了?

相关推荐
用户78506119579736 分钟前
不会前端,我靠 AI 和 Python 做了一个 4K 壁纸站
后端
噜噜学上位机37 分钟前
什么是多态?
后端
站大爷IP40 分钟前
Python的类方法把我坑惨了,原来@classmethod和@staticmethod的区别这么大
后端
Gopher_HBo1 小时前
StartCPUProfile 秒返回,是谁把 cpu.pprof 写满的?
后端
WangYu1 小时前
后端进阶路线:从写 CRUD 到定架构,这一张图讲透
后端
张紫娃1 小时前
idea 如何看一个类的 .class 文件
java·ide·intellij-idea
南宫鑫1 小时前
Java底层实现
java
AI人工智能+电脑小能手1 小时前
IP地址合法性校验,这个Java工具类4个方法纯字符不查DNS
java·网络工具·ip校验·ipv6归一·字符校验