Phaser的核心是“动态参与者+隐式阶段推进”:必须显式register()注册线程,用arriveAndDeregister()原子退出,主线程用awaitAdvance(int)协调阶段,分组协同需父子Phaser结构。

Phaser 的核心能力不是“多阶段同步”,而是「动态参与者 + 隐式阶段推进」的组合。如果你的任务需要在运行中增减线程、某些线程只参与部分阶段、主线程按阶段发号施令——直接用 new Phaser(n) 初始化就卡死在第一步。
别用 new Phaser(int) 预设人数,注册必须显式调用
传 new Phaser(5) 只是让内部计数器起始为 5,不代表这 5 个线程已合法注册。没调 register() 就直接 arrive(),必然抛 IllegalStateException: not registered。
- 正确起点是
new Phaser()或new Phaser(null, 0),从零开始 - 每个工作线程启动后、干活前第一件事:调
phaser.register() - 主线程若要参与同步(比如汇总结果),也得自己
register();如果只做协调者,就别注册,改用awaitAdvance(int)等待 - 批量注册可用
bulkRegister(int),比循环调register()略快,但它仍是“动作”,不是“上限声明”
用 arriveAndDeregister() 实现阶段性退出,不是 arrive() + 手动注销
很多场景里,线程完成第 1 阶段(如数据分片)就该释放,不该等到所有阶段结束。分两步写 arrive(); deregister(); 是错的——deregister() 根本不是 public 方法。
-
arriveAndDeregister()是原子操作:抵达当前阶段 + 从后续阶段永久移除自己 - 调用后
getRegisteredParties()立即减 1,且不影响当前阶段推进逻辑 - 错误模式:
arriveAndAwaitAdvance()后再调arriveAndDeregister()—— 前者已阻塞并推进 phase,后者可能落在新 phase,导致计数错乱 - 典型适用:某 worker 检查本地无任务,直接
arriveAndDeregister()退出,不拖慢整体
主线程靠 awaitAdvance(int) 控制阶段节奏,而非盲目 arriveAndAwaitAdvance()
主线程通常不干活,只观察。它不需要“到达并等待”,而应等待子线程把某个 phase 走完,再触发下一阶段动作(比如加载完才校验,校验完才聚合)。
-
phaser.awaitAdvance(0)表示“等 phase 0 结束”,返回时 phase 已变成 1 - 配合
getPhase()可做状态断言,但别依赖它做逻辑分支——phase 是瞬态值,竞态风险高 - 若等待超时,
awaitAdvance(int)不抛异常,而是返回当前 phase 值(等于入参说明未推进),需手动判断 - 避免在循环里高频调用
awaitAdvance(),可加短延时或结合isTerminated()防止忙等
嵌套 Phaser 处理分组协同,父子关系靠构造参数建立
当任务天然分组(如 4 组 worker 各自 map,再统一 reduce),硬塞进一个 Phaser 会导致阶段推进语义混乱。这时要用父子结构。
- 父
Phaser root = new Phaser(); - 每组新建子
Phaser group = new Phaser(root);—— 构造时传 parent,子 phaser 推进 own phase 时自动为 parentarrive() - 父 phaser 的 phase 推进,代表“所有子组均已抵达当前阶段”,天然支持 Map-Reduce 类流水线
- 注意:子 phaser 终止不会终止父 phaser;但父终止后,子
arrive()会立即返回(不再阻塞),行为需提前约定
arriveAndDeregister() 就会卡住整个阶段。这种逻辑必须和业务流程强绑定,不能靠事后补救。

















