CountDownLatch多任务等待实现解析

CountDownLatch 是 Java 并发编程中轻量、高效的一次性同步工具，专为“只等任务全部执行完毕、不关心结果”的场景而生——比如异步请求发出后统一汇总日志、批量任务完成后清理资源；它通过初始化计数、任务末尾调用 countDown()（务必放在 finally 中）、主线程 await() 阻塞等待三步精准协作，但极易因误放 countDown() 位置、漏调或多调导致死锁或提前唤醒；相比 CompletableFuture（需结果聚合）和 CyclicBarrier（可重用、需相互等待），它更纯粹、更简单，也更脆弱——用对了事半功倍，用错了则隐患难察，掌握其“一次性”“无返回值”“不处理中断”的本质特性，才能在复杂并发流程中稳准快地发出那声关键的“都完成了”。

CountDownLatch 是什么，什么时候该用它

CountDownLatch 是 Java 并发包里的一个同步辅助类，核心作用就是「让一个或多个线程等待，直到其他线程完成一组操作」。它不是用来替代 join() 或 Future.get() 的万能方案，而是当你需要**不关心任务返回值、只关心“全部执行完毕”这个信号**时最轻量的选择。

典型场景：主线程启动 5 个异步 HTTP 请求，不等结果内容，只等它们全发出去并收到响应（不管成功失败），然后统一做日志汇总或资源清理。

初始化和 await() 配合使用的关键细节

构造时传入的计数值，代表「要等待多少次 countDown() 调用」，不是线程数，也不是任务数——这点最容易错。如果漏调、多调、重复调 countDown()，都会导致 await() 永远不返回或提前返回。

• 初始化必须在所有任务启动前完成：CountDownLatch latch = new CountDownLatch(3);
• 每个任务执行完（无论成功失败）都必须调一次 latch.countDown();，推荐放在 finally 块里
• 主线程调 latch.await(); 会阻塞，直到计数归零；也可加超时：latch.await(10, TimeUnit.SECONDS)，避免无限等待
• 一旦计数归零，await() 立即返回，后续再调 countDown() 不影响已释放的等待线程

常见错误：线程没真正结束，但 latch 已被触发

现象是主线程看似“等完了”，但后台线程还在跑，甚至抛异常——因为 countDown() 被放在了任务提交处，而不是任务实际执行完的位置。

比如用 ExecutorService.submit(Runnable) 提交任务，若在 submit() 后立刻 countDown()，那只是把任务塞进了队列，根本没执行。

正确做法：

• 把 countDown() 放进 Runnable 内部，且确保在逻辑末尾或 finally 中执行
• 不要在 submit() 或 execute() 外层调 countDown()
• 如果任务本身有异常，也要保证 countDown() 执行，否则主线程永远卡住

示例片段：

CountDownLatch latch = new CountDownLatch(tasks.size());
for (Runnable task : tasks) {
    executor.execute(() -> {
        try {
            task.run();
        } finally {
            latch.countDown(); // 关键：这里才真正代表一个任务结束
        }
    });
}
latch.await(); // 主线程停在这，直到所有 finally 执行完

和 CompletableFuture、CyclicBarrier 对比时怎么选

如果你的任务需要返回结果、要组合依赖关系、或要重用同步点，CountDownLatch 就不合适了——它是一次性的，且不传递数据。

• 要等多个异步任务结果并聚合？用 CompletableFuture.allOf() + join()
• 要多个线程互相等待彼此到达某个点（可重复用）？选 CyclicBarrier
• 只发号施令：“你们干，我等你们干完”，不关心谁干了啥、干得对不对？CountDownLatch 最直接

另外注意：CountDownLatch 不处理线程中断。如果主线程在 await() 时被中断，会抛 InterruptedException 并清掉中断状态——这点常被忽略，导致上层异常吞掉或中断传播失效。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~