CountDownLatch.await()卡住的根本原因是countDown()未被调用或调用次数不足；它不自动倒数，需业务线程显式触发，且不可重置，异常需手动透出，CAS保证线程安全但语义依赖调用配平。
CountDownLatch.await() 为什么一直卡住不返回？
根本原因通常是 countDown() 没被调用，或调用次数少于初始化的计数值。它不是“自动倒数”，必须由业务线程显式触发。
常见错误现象：await() 阻塞后程序无响应、日志停在某处、超时后抛出 InterruptedException 但没看到倒数动作。
- 检查所有可能执行
countDown()的分支——比如异常路径下漏写了，或条件判断导致根本没进执行块 - 确认调用
countDown()的线程确实启动并运行到了该行（加日志或断点验证） - 注意：
CountDownLatch不可重置，一旦计数归零，后续所有await()会立即返回；如果误以为还能复用，就会发现“第二次等待不生效”
多个子任务完成才继续，但有的任务失败了怎么办？
CountDownLatch 本身不处理异常传递，它只管计数，不管成败。你得自己把异常捕获并透出，否则主线程根本不知道哪错了。
典型使用场景：启动 5 个异步 HTTP 请求，全部返回后再聚合结果。如果其中 1 个 404 或超时，await() 仍会结束，但数据已残缺。
- 用
AtomicReference<exception></exception>或volatile Exception在各子线程中记录首个异常 - 主线程
await()返回后，先检查异常引用是否非空，再决定是继续处理还是抛出 - 别依赖
isTerminated()或getCount()判断成功与否——它们只反映计数状态，和业务逻辑无关
和 CompletableFuture.allOf() 比，什么时候该选 CountDownLatch？
选 CountDownLatch 的核心信号是：你只关心“数量到没到”，不关心每个任务的结果类型、不需要链式编排、也不需要组合异常策略。
性能与兼容性上：CountDownLatch 更轻量（JDK 5 就有），无额外对象分配；而 CompletableFuture.allOf() 要求 JDK 8+，且返回的是 CompletableFuture<void></void>，隐含了回调调度开销。
- 适合简单同步点：比如“等 3 个线程初始化完配置再启动主服务”
- 不适合：需要对每个子任务结果做 map/filter/exceptionally 处理
- 参数差异明显：
CountDownLatch构造器只接受一个int；allOf()必须传CompletableFuture[]，且数组不能为 null 或含 null 元素
主线程中断后 CountDownLatch 还安全吗？
安全，但行为要心里有数：await() 被中断时会立刻抛出 InterruptedException，并**不清除中断状态**，也不会影响其他线程对 countDown() 的调用。
容易踩的坑是：捕获异常后没重设中断标志，导致上层调用者感知不到中断意图；或者误以为抛异常 = 计数器失效，其实 getCount() 依然准确反映剩余值。
- 标准做法：在
catch (InterruptedException e)块里调用Thread.currentThread().interrupt() - 不要在
await()外层套try-catch后静默吞掉异常——这会让调试变得极其困难 - 如果用了带超时的
await(long, TimeUnit)，返回false表示超时，此时中断状态未被触发，也无需重设
最常被忽略的一点：CountDownLatch 的计数逻辑是 CAS 实现，线程安全，但它的“语义完整性”完全依赖你手动配平 countDown() 调用次数——少一次，就永远等不到；多一次，可能让别的等待提前释放，引发竞态。
