CyclicBarrier用于协调分片下载后的统一合并，不参与HTTP下载过程；需服务端支持Range请求，各线程独立下载指定字节区间并写入临时文件，全部调用await()后触发回调合并。
用 CyclicBarrier 实现分片下载大文件并合并，核心不是靠它“控制下载”，而是用它**协调多个线程完成各自分片后统一等待，再触发合并动作**。它本身不处理 HTTP、IO 或断点续传，但能干净地解决“所有分片就绪才开始合并”这个同步问题。
一、明确分片下载的关键前提
在用 CyclicBarrier 之前，必须确保服务端支持 Range 请求（即 HTTP 分段下载），且客户端能精确计算每个线程负责的字节区间：
- 通过 HEAD 请求获取文件总大小（
Content-Length） - 按线程数均分区间，例如 4 线程下载 100MB 文件：0–24.9MB、25–49.9MB、50–74.9MB、75–99.9MB
- 每个线程独立发起带
Range: bytes=start-end的 GET 请求，并写入临时文件（如file.part0,file.part1）
二、CyclicBarrier 的正确用法：仅做“就绪门控”
CyclicBarrier 在这里只承担一个职责：让所有下载线程各自完成后阻塞等待，等最后一个线程到达，就一起放行——此时可安全执行合并。不要把它用于控制下载过程本身。
示例初始化（4 个分片）：
立即学习“Java免费学习笔记（深入）”；
int threadCount = 4;
CyclicBarrier barrier = new CyclicBarrier(threadCount, () -> {
// 所有线程到达后，自动执行：合并临时文件
mergeParts("target.zip", threadCount);
});
注意：第二个参数是 Runnable，会在最后一个线程调用 barrier.await() 后、所有线程被唤醒前执行，适合放合并逻辑。
三、每个下载线程的典型结构
每个线程负责一个分片，完成后调用 barrier.await()。需捕获中断和超时异常，避免死等：
new Thread(() -> {
try {
downloadPart(url, start, end, "file.part" + index);
System.out.println("✅ 分片 " + index + " 下载完成");
barrier.await(); // 到达屏障点
} catch (InterruptedException | BrokenBarrierException e) {
Thread.currentThread().interrupt();
System.err.println("⚠️ 分片 " + index + " 下载异常：" + e.getMessage());
}
}).start();
关键点：
- 每个线程必须调用且仅调用一次
await() - 若某线程失败，其他线程会抛
BrokenBarrierException，需统一处理（如清理临时文件、抛出业务异常） - 不建议在
await()前加锁或耗时操作，否则拖慢整体进度
四、合并部分：顺序拼接临时文件
合并逻辑放在 CyclicBarrier 的回调中，用 Files.write(..., StandardOpenOption.APPEND) 或 FileChannel.transferFrom 高效拼接：
void mergeParts(String targetPath, int partCount) throws IOException {
try (var out = Files.newOutputStream(Paths.get(targetPath))) {
for (int i = 0; i < partCount; i++) {
Path part = Paths.get("file.part" + i);
Files.copy(part, out);
Files.delete(part); // 合并后清理
}
}
}
注意：
- 确保分片文件按序命名（
.part0,.part1...），否则合并顺序错乱 - 生产环境建议校验每个分片的 SHA256，再合并，防下载损坏
- 合并过程本身不涉及
CyclicBarrier，它是纯 IO 操作，放在回调里刚好满足“全部就绪才开始”
不复杂但容易忽略：CyclicBarrier 是协作工具，不是下载框架。真正健壮的分片下载还需处理重试、连接复用、内存缓冲、进度回调和异常恢复——这些都得靠 HttpClient、NIO 或成熟库（如 OkHttp + 自定义 Range 下载器）来支撑，CyclicBarrier 只管好“最后一公里”的协同。
