phaser 的同步逻辑核心是解耦阶段推进与参与者管理,通过 arriveandawaitadvance 驱动阶段演进,支持动态注册/注销、onadvance 自定义控制及嵌套结构实现可伸缩协作。

Phaser 的同步逻辑设计核心在于把“阶段推进”和“参与者管理”彻底解耦,让线程协作能随任务实际需要自然伸缩,而不是被固定人数或单次使用卡死。它不靠预设总数驱动,而是靠每个线程主动到达(arrive)触发阶段演进,再配合运行时注册与注销,支撑真实业务中常见的分片增减、失败熔断、资源回收等场景。
阶段推进:用 arriveAndAwaitAdvance 驱动节奏
每个线程完成当前阶段工作后,必须调用 arriveAndAwaitAdvance()。这个方法不是单纯等待,而是两步合一:先标记自己已到达,再阻塞直到所有当前已注册的参与者都完成这一步。一旦齐备,Phaser 自动将 phase 编号加 1(从 0 开始),唤醒全部线程进入下一阶段。
- 阶段编号对业务透明,线程只需在每个阶段末尾统一调用,无需关心 phase 是几
- 若只需上报不等待,可用 arrive(),适合日志打点或异步通知
- 主线程可通过 getPhase() 实时读取当前阶段,用于监控或条件判断
动态参与者:注册与退出必须原子且显式
Phaser 不允许“声明式占位”,new Phaser(5) 只是初始化计数器,并不代表已有 5 个合法参与者。任何未 register() 就调 arrive 的操作都会抛 IllegalStateException。
- 新线程启动后第一件事:调 register(),立即成为当前及后续阶段的参与者
- 任务完成或异常退出时:必须用 arriveAndDeregister(),一步到位完成“到达 + 注销”
- 批量加入可选 bulkRegister(n),适用于预知子任务数的场景,比如固定分片池
- 主线程若参与协调(如汇总结果),同样要 register();若只发令不干活,可不注册,但需用 awaitAdvance 等待
自定义阶段逻辑:onAdvance 控制流程生命线
重写 onAdvance(int phase, int registeredParties),就能在每次阶段切换前插入业务控制逻辑。phase 是即将结束的阶段号,registeredParties 是下一阶段预计参与线程数。
- 返回 false 表示继续下一阶段,常用于记录日志、校验中间结果、触发清理动作
- 返回 true 表示终止 Phaser,后续 arrive 调用会立即返回负值,适合异常熔断或流程收尾
- 例如:phase=2 时检查数据一致性,失败则 return true,阻止进入汇总阶段
结构可伸缩:避免单点瓶颈,善用嵌套与生命周期绑定
大规模任务不能全堆在一个 Phaser 下。天然分组的任务(如多组 worker 并行 map,再统一 reduce),应采用嵌套结构:
- 每组内部用一个子 Phaser,负责组内线程的阶段对齐
- 主 Phaser 协调各组整体进度,比如等所有子组完成 map 后才推进到 reduce 阶段
- Phaser 实例必须绑定单次任务生命周期,例如按 taskID + triggerTime 创建,禁止全局复用
- 任一子任务抛出未捕获异常,主线程可调 forceTermination() 快速终止整个流程











