模块级降级指当功能模块依赖的异步资源持续不可用时，跳过其初始化、返回兜底数据并保障主流程可用；通过封装模块加载为熔断单元、设置语义化超时、定制fallback及绑定生命周期状态来实现。
“模块化熔断机”并不是一个标准术语，当前主流框架（如 Hyperf、Resilience4j、Sentinel）中也没有名为“模块化熔断机”的独立组件。但你描述的场景——在异步加载超时后，自动触发整个模块级别的业务降级逻辑——是真实存在的高可用设计需求，本质是将熔断与模块生命周期/功能边界对齐，而非仅作用于单个方法或HTTP接口。
明确目标：什么是“模块级降级”
它指当某个功能模块（例如“用户画像模块”“商品推荐模块”“实时风控模块”）所依赖的异步资源（远程服务、缓存、数据库查询、第三方SDK初始化等）持续不可用或超时时，系统不再尝试加载该模块，而是：
- 跳过该模块的初始化或执行流程
- 返回预置的轻量兜底数据（如空列表、静态配置、本地缓存快照）
- 保持主流程（如页面渲染、订单创建）不受影响
- 记录模块不可用状态，供监控与告警使用
实现路径：用标准熔断器 + 模块抽象封装
无需自研“模块化熔断机”，而是通过组合现有能力达成效果：
-
把模块加载行为包装成可熔断的单元：例如将
UserProfileModule::loadAsync()方法用#[CircuitBreaker]注解包裹（Hyperf），或用CircuitBreaker.decorateSupplier()封装（Resilience4j） - 超时设置匹配模块语义：不是设 500ms，而是设模块初始化合理上限（如推荐模块首次加载允许 1.2s，超时即判定模块不可用）
-
降级回调直接返回模块兜底态：fallback 方法不抛异常，而是返回
new UserProfileModule(new EmptyUserProfileData())或启用本地 mock 策略 -
模块实例持有熔断器引用：模块对象内部维护自身状态（
isAvailable()），主流程调用前先检查，避免重复触发熔断逻辑
关键细节：异步加载场景下的状态协同
异步加载（如 Promise、协程、CompletableFuture）需特别注意熔断状态与执行上下文的一致性：
- 熔断器必须绑定到模块实例生命周期，不能每次调用都新建；否则半开探测会失效
- 超时异常（如
TimeoutException）必须被熔断器捕获并计入失败统计，不能被上层catch吞掉 - 若模块支持“懒加载+后台刷新”，可在半开状态下触发一次后台健康探测，成功后再恢复前台可用性
- 建议为模块级熔断单独配置滑动窗口（如 60 秒内失败 3 次即熔断），区别于接口级的高频短窗口
一个 Hyerf 下的轻量示例结构
假设有一个 RecommendModule：
#[CircuitBreaker(
timeout: 1.2,
failCounter: 3,
successCounter: 2,
fallback: [RecommendModule::class, 'fallback']
)]
public function loadAsync(): Promise
{
return $this->httpClient->get('https://api.recom.example/v1/initial');
}
public static function fallback(): RecommendModule
{
// 返回无网络依赖的兜底模块实例
return new RecommendModule(new StaticRecommendStrategy());
}
主流程中统一通过 $module->isAvailable() && $module->render() 判断执行路径，自然实现模块级开关。
