用途:帮助应用在依赖故障时继续运行,通过回退(fallback)、特性降级与部分响应模式,避免单点故障导致整体不可用。适用场景包括外部 API 依赖、非关键功能、高可用要求、微服务架构与第三方集成。
主要能力:提供 withFallback 封装,支持主逻辑超时、失败后调用回退、按错误类型决定是否回退、回退回调与超时配置;回退策略涵盖缓存数据、默认值、降级功能、排队延后与友好错误提示。部分响应模式允许必需数据失败即报错,非必需数据失败则返回 null 并记录错误。特性降级类可自动标记失败特性、定时健康检查恢复。
使用方式:TypeScript 中定义 FallbackOptions 并调用 withFallback;Python 中提供 with_fallback 异步函数与 degradable 装饰器,可指定 fallback_value、fallback_func 与 timeout。前端根据返回的 degraded 标记或 null 字段展示降级提示与备用 UI。
限制与注意:资料未提供安装命令、包名或版本信息;示例代码需按项目环境适配。最佳实践包括区分关键与非关键功能、始终准备回退、向用户明示降级、监控回退频率、测试故障场景;常见错误为外部依赖无回退、隐藏降级、回退本身易失败、未监控回退频率及级联故障。