在Java里如何使用CountDownLatch实现线程等待_Java同步工具解析

风杰大大_7596

风杰大大_7596

2026-01-21

176人浏览

原创

CountDownLatch 是一个同步辅助类,用于让一个或多个线程等待其他线程完成一组操作;其核心是基于计数器的 await() 阻塞与 countDown() 减一机制,适用于主线程等待子任务完成、服务初始化就绪等场景,且不可重置。

在java里如何使用countdownlatch实现线程等待_java同步工具解析

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

CountDownLatch 不是锁,而是一个同步辅助类,用来让一个或多个线程等待其他线程完成一组操作。它的核心是内部一个 count 计数器,调用 countDown() 会减一,调用 await() 的线程会阻塞直到计数器归零。

典型场景包括:主线程等待多个子任务全部完成再继续;测试中模拟并发启动;服务启动时等待所有初始化模块就绪。

注意:它是一次性用品——计数器归零后,await() 立即返回,不能再重置(想重复用请换 CyclicBarrier)。

基本用法:初始化、倒计时、等待三步走

构造时指定初始计数值,每个协作线程完成工作后调用 countDown();主控线程在关键点调用 await() 阻塞等待。

Java Development Man
Java Development Man

Java开发手册规约集合,基于阿里巴巴Java开发手册(嵩山版)。 涵盖7大维度:编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。

下载
  • CountDownLatch 构造参数必须 > 0,否则抛 IllegalArgumentException
  • await() 可被中断,需处理 InterruptedException
  • countDown() 是无锁的 CAS 操作,安全且轻量
CountDownLatch latch = new CountDownLatch(3);

// 启动 3 个子线程
for (int i = 0; i  {
        try {
            // 模拟任务执行
            Thread.sleep(1000);
        } catch (InterruptedException e) {
            Thread.currentThread().interrupt();
            return;
        }
        System.out.println("Task done");
        latch.countDown(); // 计数器减一
    }).start();
}

try {
    latch.await(); // 主线程等待所有子线程完成
    System.out.println("All tasks finished");
} catch (InterruptedException e) {
    Thread.currentThread().interrupt();
}

带超时的 await() 要小心返回 false 的含义

await(long timeout, TimeUnit unit) 在超时后返回 false,不代表失败,只说明“还没等到计数器归零”。此时你得自己判断后续逻辑:是重试?放弃?还是强制清理?

  • 返回 false 时,latch.getCount() 仍大于 0,可用来诊断卡在哪一步
  • 超时值设太小容易误判;设太大又拖慢响应——建议结合业务 SLA 设定,比如接口最大容忍等待 5 秒
  • 不要在 await() 超时后直接忽略未完成的子任务,它们可能还在后台运行并修改共享状态

常见陷阱:忘记 countDown、异常绕过 countDown、重复 await

最常出问题的是子线程在异常路径下没调用 countDown(),导致主线程永远阻塞。另一个误区是认为多次调用 await() 有副作用——其实没有,只要计数器已为 0,每次都会立即返回。

  • 务必把 countDown() 放在 finally 块里,确保无论是否异常都执行
  • 不要在同一个 CountDownLatch 实例上调用多次 await() 并期望“二次等待”,它不维护等待者列表,只是检查当前计数
  • 避免在循环中反复 new CountDownLatch(1)——这通常是设计错误,应考虑用 CompletableFuture 或更细粒度的协调方式

真正难调试的问题,往往藏在那个没进 finally 的 return 或吞掉异常的 catch 里。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关专题

更多
counta和count的区别
counta和count的区别

Count函数用于计算指定范围内数字的个数,而CountA函数用于计算指定范围内非空单元格的个数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.11.20

3968

5

硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

2023.10.19

3248

3

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

2025.10.17

5509

12

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2025.12.29

3909

9

java接口相关教程
java接口相关教程

本专题整合了java接口相关内容,阅读专题下面的文章了解更多详细内容。

2026.01.19

506

15

线程和进程的区别
线程和进程的区别

线程和进程的区别:线程是进程的一部分,用于实现并发和并行操作,而线程共享进程的资源,通信更方便快捷,切换开销较小。本专题为大家提供线程和进程区别相关的各种文章、以及下载和课程。

2023.08.10

4898

6

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

100

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

60

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

60

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习