Opossum
Opossum 是 Red Hat 维护的 Node.js 熔断器库（nodeshift/opossum）——它把「可能失败的异步操作」（HTTP 调用、数据库查询、下游服务访问）包进一个熔断器（Circuit Breaker），用滑动窗口统计错误率，一旦失败超过阈值就「跳闸（Open）」让后续请求快速失败（fail fast）而不是傻等，从而防止下游故障级联放大成整个系统的雪崩。它是微服务容错设计的核心组件：当某个下游服务变慢或挂掉，熔断器在客户端就切断调用、走 fallback 降级，让上游服务还能（部分）正常工作。名字「Opossum（负鼠）」源于它的行为——遇到危险就装死（plays dead），正如熔断器在故障时「快速失败」。
Opossum 的全部考点围绕熔断器三态机与容错模式展开：①熔断器三态（Closed 闭合正常调用 → Open 打开快速失败 → Half-Open 半开试探恢复）；②fallback 降级（熔断时返回兜底数据，保业务可用）；③配置选项（timeout 超时、errorThresholdPercentage 错误率阈值、resetTimeout 重置时间、rollingCountTimeout 滑动窗口、volumeThreshold 最小调用量）；④事件机制（success/failure/open/close/fallback 等事件，用于监控告警）；⑤与其他容错模式的关系（超时、重试、限流、舱壁隔离——熔断器是其中「防级联」的一环）；⑥与 circuit-breaker-js 的对比（后者 2013 年后基本停更，Opossum 是 Node.js 生态事实标准）。本叶是容错设计的总览与地基，讲清熔断器原理、Opossum 配置与事件、容错模式组合拳。
评价
优点
- 防雪崩：下游故障时快速失败，避免请求堆积拖垮上游线程池/连接池，是微服务容错第一道防线
- 自动恢复：Half-Open 状态周期性试探下游，恢复后自动闭合，无需人工干预
- 配置灵活：错误率阈值、超时、滑动窗口、最小调用量等参数可精细调控熔断策略
- fallback 降级：熔断或失败时返回兜底数据，保证业务「降级可用」而非完全中断
- 可观测：丰富的事件（open/close/fallback/timeout）+ Prometheus/Hystrix 指标集成，监控告警完备
- Red Hat 背书：Red Hat Build of Node.js 官方支持，企业级可靠
缺点
- 仅限 Node.js：单语言生态，Java 有 Resilience4j/Hystrix、Go 有 go-resilience，跨语言不通
- 不解决根因：熔断器是「症状治疗」，下游真挂了还是得修，它只争取时间防级联
- 配置不当有害：阈值设太低误熔断（正常抖动就跳闸）、设太高不熔断（失去保护），需配合监控调参
- fallback 设计成本：每个熔断点都要想清楚降级逻辑（返回缓存？默认值？空结果？），增加开发负担
- 不处理异步复杂度：只管「调用成功/失败」，业务事务的幂等、补偿要自己做
本叶地图
- 入门 —— Opossum 是什么、熔断器三态（Closed/Open/Half-Open）、滑动窗口错误率、fallback 降级、核心配置项
- 熔断器原理详解 —— 三态状态机、错误率计算、Half-Open 试探、fallback 机制、事件清单
- 容错模式与对比 —— 超时/重试/限流/舱壁隔离与熔断器的关系、Opossum vs circuit-breaker-js、与 Resilience4j 对比
- 参考 —— 配置项速查、事件清单、三态转换图、易错点