应为每个业务模块创建独立Phaser实例并命名空间化phase标识,封装阶段为含模块名、序号、语义标签的PhaseToken,切面按模块声明式注册,跨模块协同通过事件或状态桥接实现。

在大厂级多业务线并行场景中,Phaser 的阶段标识若缺乏统一规范,极易导致切面逻辑(如监控、降级、灰度路由)误判当前执行上下文,把 A 模块的 phase=3 当作 B 模块的 phase=3 处理,从而拦截、跳过或错误增强本不该干预的任务。核心不是“用不用 Phaser”,而是“怎么让每个模块的阶段语义自包含、不可混淆”。
为每个模块绑定独立 Phaser 实例 + 命名空间化 phase 标识
禁止多个业务模块共享同一个 Phaser 实例——这是误伤的根源。每个模块初始化时应创建专属 Phaser,并在注册时注入模块标识前缀:
- 订单模块:phaser = new Phaser(3, () → {}); phaser.register(); 同时将 module: "order" 写入上下文(如 ThreadLocal 或 task metadata)
- 营销模块:单独 new Phaser(5),并标记 module: "marketing"
- 切面逻辑(如熔断器)读取当前任务的 module + getPhase() 组合键,例如 "order:4" 和 "marketing:4" 视为完全不同的阶段状态,互不干扰
阶段号不裸用 int,统一升维为结构化 PhaseToken
直接比对 phaser.getPhase() 返回的整数,无法区分模块归属和阶段意图。应封装为不可变 Token 对象:
- PhaseToken.of("order", 5, "pay_confirmation") —— 包含模块名、阶段序号、语义标签三元组
- 所有切面拦截器(如日志埋点、权限校验、流量染色)只接受 PhaseToken 参数,拒绝 raw int
- Phaser 的 onAdvance() 回调中,由模块自身构造并分发该 Token,而非透传原始 phase 值
切面注册与生命周期对齐模块边界
全局切面不能无差别作用于所有 Phaser 参与者。需支持按模块声明式注册:
- 在模块启动时,显式调用 AspectRegistry.bind("order", PayPhaseMonitor.class),绑定仅响应 order 模块 phase 变更的监控器
- 模块卸载时自动解绑,避免残留监听器捕获其他模块的 phase 事件
- CI 流水线加入检查:禁止在非模块初始化代码中调用 AspectRegistry.bind(),防止硬编码污染
跨模块协同阶段需显式桥接,禁用隐式 phase 映射
当订单模块需等待营销模块完成优惠核验(即跨模块阶段同步),不能让两者共用一个 Phaser,也不能靠“phase 数值相等”来判断就绪——这会破坏模块隔离。
- 采用事件桥接:营销模块在 phase=2 完成后 emit("marketing:coupon_validated", token),订单模块订阅该事件并推进自身阶段
- 或使用状态桥接层:在页面/流程级聚合 store 中维护 { orderPhase: 3, marketingPhase: 2 },由协调器判定整体进度,不暴露底层 Phaser 实例
- 静态分析工具拦截:禁止 import java.util.concurrent.Phaser 跨模块传递;禁止在 service 接口中定义返回 Phaser 或接收 phase int 参数


















