phaser 的 onadvance 方法在每次阶段切换前被调用一次，返回 true 即终止；常见终止方式包括按阶段序号（如 phase >= 3）、参与者数为零或业务条件满足；需避免耗时操作和 phase 语义误解。
Phaser 的 onAdvance 方法是控制多阶段任务生命周期的核心入口，它不负责“周期性”执行，而是**在每次阶段切换前被调用一次**——也就是说，它天然对应“阶段变化点”，而非定时循环。所谓“周期性并发任务的终止”，本质是：在某个特定阶段（如第 N 轮结束时）或满足某条件（如无参与者、异常状态）后，让 Phaser 停止推进，进入终止状态。
onAdvance 触发终止的关键逻辑
该方法签名是：protected boolean onAdvance(int phase, int registeredParties)。返回 true 即触发终止，所有阻塞在 awaitAdvance 或 arriveAndAwaitAdvance 的线程会立即被唤醒并继续执行；返回 false 则正常进入下一阶段。
- 默认行为：当
registeredParties == 0时，父类实现自动返回true，即无人参与时自动终止 - 自定义终止：继承
Phaser，重写此方法，在其中加入业务判断，满足条件就 return true - 注意 phase 是“即将结束”的当前阶段编号（从 0 开始），不是“将要进入”的下一阶段
常见终止控制场景与写法
根据实际任务模型，终止时机通常有三类：
-
按阶段序号终止：比如考试共 3 轮，第 3 轮结束后终止
→ 在onAdvance中判断phase == 3（即刚完成第 3 阶段，准备进第 4 阶段时），返回true -
按参与者数量终止：例如某阶段后部分线程注销，只剩 1 人时不再继续
→ 检查registeredParties ，满足则终止 -
按业务结果终止：比如某轮所有线程上报失败，后续无需再试
→ 需配合共享状态（如AtomicBoolean failed），在onAdvance中读取并决定是否终止
必须避开的典型误区
实际开发中容易踩坑的地方：
- 误把
phase当作“已执行阶段数”：phase == 2表示刚完成第 2 阶段（即总共经历了 0→1→2 两次切换），不是“已完成 2 轮” - 忽略动态注册影响：若运行中调用
register()，后续phase可能跳变（如从 2 直接到 5），不能硬编码阶段上限 - 在
onAdvance中执行耗时操作：该方法在同步关键路径上，阻塞会导致所有线程卡住，应只做轻量判断和日志 - 忘记检查终止后状态：调用
isTerminated()可确认，但更稳妥的是让各线程在arriveAndAwaitAdvance()返回后主动检查phaser.getPhase()是否异常（如返回负值）
一个简洁可靠的终止示例
模拟最多执行 4 轮（phase 0~3），第 4 轮完成后终止：
class LimitedPhaser extends Phaser {private final int maxPhase;
LimitedPhaser(int maxPhase) { this.maxPhase = maxPhase; }
@Override
protected boolean onAdvance(int phase, int registeredParties) {
// phase == maxPhase 表示刚完成第 maxPhase 阶段，准备进 maxPhase+1
return phase >= maxPhase || registeredParties == 0;
}
}
使用时构造 new LimitedPhaser(3)，即可保证 phase 0、1、2、3 四轮执行完后终止（phase=3 时返回 true）。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
