导出两笔订单,读线程第一次打开 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 说明
下次测导出,可以把断言提前一次:停在第一批写完的时候,从真实的下载入口读一遍。你的接口此时会告诉用户"还在生成",还是已经把第一批数据发给他了?