Phaser不传播异常，任务失败需线程层try-catch封装并透出堆栈；必须显式arriveAndDeregister、用ThreadLocal存异常快照、onAdvance轻量标记失败、分阶段使用独立Phaser实例。
Phaser 本身不传播异常，也不保存堆栈——它只响应“到达”动作。任务失败时若未主动处理，真实异常会直接丢失，后续线程卡在 arriveAndAwaitAdvance() 上，连原始错误都看不到。要保留完整堆栈，关键不是让 Phaser 做什么，而是在线程执行层把异常兜住、封装、带上下文透出。
每个工作线程必须 try-catch 并显式传递异常
不能依赖异常向上冒泡，Phaser 不拦截、不转发、不记录任何 Throwable。所有参与线程的 run() 或 call() 体必须包裹 try-catch：
- 正常路径：调用
phaser.arriveAndAwaitAdvance() - 异常路径：在
catch中先记录日志（用logger.error("阶段X执行失败", e)），再调用phaser.arriveAndDeregister()主动退出 - 禁止在 catch 里只写
return或吞掉异常——这会导致 Phaser 等不到你，也看不到错在哪
用 ThreadLocal 或任务元数据绑定异常快照
单靠日志还不够，有时需要让下游或监控线程能读到“谁在哪个 phase 失败了、堆栈是什么”。可在任务启动时把异常容器挂到上下文：
- 定义
static final ThreadLocal<throwable> CURRENT_ERROR = new ThreadLocal();</throwable> - catch 块中：
CURRENT_ERROR.set(e); logger.error("phase {} 异常", phaser.getPhase(), e); - 主线程检测到阻塞超时后，可遍历活跃 worker 线程（需配合自定义 ThreadFactory），读取其
CURRENT_ERROR.get()获取原始堆栈
onAdvance 中做轻量级失败标记，避免堆栈二次丢失
onAdvance() 是唯一能在阶段跃迁时统一检查的钩子。它不接收异常，但可以基于参与者数量变化反推失败：
立即学习“Java免费学习笔记（深入）”；
- 例如预期 5 个清洗线程，但
registeredParties == 3，说明至少 2 个已 deregister —— 结合时间戳和日志，大概率是异常退出 - 此时可在该方法内触发告警，并把当前
phaser.getPhase()和模块标识写入失败事件，附上“最近一条 ERROR 日志的 traceId” - 注意：不要在 onAdvance 里打印堆栈或调用耗时操作，它运行在 Phaser 内部锁中，必须轻量
长流程分阶段解耦，让异常止步于本阶段 Phaser
一个大流程共用一个 Phaser，失败就会污染全局。应按语义切分，每阶段独立实例：
- 加载阶段用
loadPhaser，清洗阶段用cleanPhaser，汇总阶段用reducePhaser - 每个阶段失败只影响自身 Phaser，不会拖垮后续阶段；各阶段的日志、ThreadLocal、监控指标也天然隔离
- 跨阶段传递结果用队列或状态对象，而不是靠“等同一个 Phaser 到 phase=3”——那样一旦上游失败，下游永远等不到，堆栈也无从追溯
堆栈不是 Phaser 的责任，而是每个任务线程的契约。守住这个边界，异常才不会消失在同步屏障之后。
