Phaser 是为动态、多阶段、可变参与线程数的协作场景设计的同步工具;适用于准备→预处理→主计算→汇总等分阶段且每阶段线程数可变的流程。

Phaser 是什么,适合解决哪类问题
Phaser 不是替代 CountDownLatch 或 CyclicBarrier 的“升级版”,而是为**动态、多阶段、可变参与线程数**的协作场景设计的。如果你的流程分多个明确阶段(比如:准备 → 预处理 → 主计算 → 汇总),且每阶段可能有不同线程加入或退出,Phaser 比手动维护多个屏障更简洁、更安全。
如何正确初始化和注册线程
常见错误是直接 new 一个 Phaser() 就用,结果线程调用 arriveAndAwaitAdvance() 时卡死——因为没注册。注册必须显式完成:
- 构造时传入初始参与者数:
new Phaser(3)表示期待 3 个线程参与第一阶段 - 或用
phaser.register()在线程内手动注册(适用于线程启动后才决定是否参与) - 注意:
register()必须在任何arrive*调用前执行;否则该线程的到达不会被计数
Phaser phaser = new Phaser(2); // 主线程 + 1 个工作线程
Thread worker = new Thread(() -> {
phaser.register(); // ✅ 显式注册(若构造未覆盖全部)
// ... 工作逻辑
phaser.arriveAndAwaitAdvance(); // 等待所有注册者到达本阶段终点
});
控制阶段推进与获取当前阶段号
Phaser 的阶段号从 0 开始,每次所有注册线程都调用 arriveAndAwaitAdvance() 后自动加 1。关键点:
-
arriveAndAwaitAdvance():阻塞直到本阶段所有已注册线程都到达 -
arrive():仅计数,不阻塞;适合“只上报不等待”的角色(如日志线程) -
getPhase()返回当前阶段号,可用于条件分支(例如:阶段 2 才启动 DB 写入) - 阶段推进是**隐式同步点**,不能跳过或回退
int phase = phaser.getPhase();
if (phase == 2) {
writeToDatabase(); // 仅在第三阶段执行
}
phaser.arriveAndAwaitAdvance();
如何安全终止 Phaser 并释放资源
Phaser 不会自动销毁。如果某阶段后不再需要同步,必须主动注销线程,否则后续 arrive* 可能永远等不到它:
立即学习“Java免费学习笔记(深入)”;
- 单个线程退出前调用
phaser.arriveAndDeregister() - 主线程可在所有工作完成、确认无新参与者后调用
phaser.forceTermination(),让所有阻塞中的arriveAndAwaitAdvance()立即返回负值(表示已终止) - 调用
forceTermination()后,isTerminated()返回 true,且所有后续操作(除getPhase())抛IllegalStateException
容易忽略的是:注销不等于终止。线程注销后,只要还有其他注册者,Phaser 仍会继续推进阶段;只有所有线程都注销,且无人再注册,Phaser 才自然“空转”结束。










