优雅的失败回退机制需分层判断错误性质、按业务影响分级响应,主动校验状态码与业务code,结合async-retry的bail()实现可控重试,配合Promise.allSettled、分级fallback及统一执行壳封装。

为 async 函数设计优雅的失败回退机制,核心不是“一错就 fallback”,而是分层判断错误性质、按业务影响分级响应,并让回退本身可预期、可控制。
明确区分错误类型,决定是否重试或降级
网络超时、服务暂时不可用这类临时性错误值得重试;而 401 认证失败、404 资源不存在、500 业务逻辑错误则通常不该重试,应直接触发回退。关键在于主动校验响应状态,而非只依赖 try-catch 捕获抛出的异常。
- fetch 后手动检查 response.status,对 4xx/5xx 主动 throw 或调用 bail()
- 业务返回体中检查 code 字段(如 { code: -1, msg: "库存不足" }),非 0 时明确 throw 新错误
- 避免把所有 reject 都交给 retry 库兜底——它无法识别语义错误
用 async-retry 实现可控重试 + 智能终止
async-retry 不是“自动重试一切”,而是提供 bail() 函数让你在特定错误下立即退出重试流程,避免无效循环。
- 在 retry 回调中传入 bail,遇到认证失败、参数错误等确定性错误时调用 bail(new Error('...'))
- 配置 retries、minTimeout、factor 实现指数退避,防止雪崩
- 结合 Promise.allSettled 处理并行请求:每个子请求独立重试+回退,整体不因单个失败而中断
按业务重要性分级回退策略
不是所有失败都该展示“加载失败”,也不是所有失败都要静默兜底。回退方式需匹配模块重要性:
- 核心链路(如支付确认):错误必须透出,引导用户重试或联系客服
- 辅助信息(如推荐商品、用户头像):可返回空数组、占位图或缓存旧数据
- 埋点上报、日志写入等非关键操作:失败可忽略,或异步补偿,不影响主流程
封装统一的异步执行壳,收敛错误处理逻辑
避免每个 async 函数都手写 try/catch + bail + fallback。可封装一个高阶函数,集中处理校验、重试、降级、上报:
- 输入:业务函数、重试配置、fallback 值、错误分类映射表
- 内部自动做 status/code 校验,匹配规则后走对应回退分支
- 记录结构化日志(traceId、错误码、重试次数),便于定位问题











