async错误处理核心是分层捕获与结构化归因：API层转HTTP状态为结构化错误，业务层区分降级/中断，组件层依ok字段渲染；并行用allSettled，单个await用to封装为元组，按错误类型设定传播边界。
在 async 函数中处理异步依赖的错误，关键不是“堵住错误”，而是让错误可预期、可区分、可响应。依赖链越深，越不能靠一层 try/catch 包到底——那样会掩盖失败环节、混淆错误类型、阻断后续流程。
按依赖层级分层捕获
每个异步调用应承担自己的错误归因责任：底层（如 API 封装）负责把网络异常、HTTP 状态码、解析失败转为结构化错误对象；中间层（如 service 方法）负责组合多个依赖，并区分哪些失败可降级、哪些必须中断；顶层（如组件 onLoad）只做状态反馈与用户引导。
- API 层统一拦截 fetch 响应：401 转
{ code: 'UNAUTHORIZED', message: '登录已过期' }；500 转{ code: 'SERVER_ERROR', message: '服务暂不可用' } - 业务层不 throw 原始 error，而是返回
{ ok: false, error: { type: 'NETWORK', detail: ... } }或{ ok: true, data: ... } - 组件层只根据
ok字段决定渲染 loading / 成功视图 / 错误提示，不解析原始堆栈
用 allSettled 处理并行依赖
当多个异步操作互不阻塞（如同时拉取用户信息、权限列表、配置项），用 Promise.allSettled 替代 all。它确保任一失败不影响其余结果，也避免“一个挂全链断”。
Javascript Sdk
下载
用于 inference.sh 的 JavaScript/TypeScript SDK，可运行 AI 应用、构建代理、集成 150+ 模型。包名：@inferencesh/sdk（npm install），完整 TypeScript 支持。
- 结果是数组，每项含
status: 'fulfilled' | 'rejected'和对应value或reason - 可逐项判断：成功则 merge 数据；失败则记录
reason.message用于上报，或触发局部重试 - 不推荐再对 each 结果套 try/catch——allSettled 已把拒绝态转为确定值，直接 if 分支即可
用 to() 封装单个 await 的成败
避免为每个 await 写独立 try/catch。用轻量封装（如 to = p => p.then(d => [null, d]).catch(e => [e, null])）把 Promise 转为 [error, data] 元组，让错误成为数据流的一部分。
- 写法更线性：
const [err, user] = await to(fetchUser()); if (err) return handleError(err); - 天然支持条件跳过：若 user 获取失败但 fallback 头像可用，可直接走降级逻辑，无需抛异常中断后续
- 便于统一日志：所有
err都带 timestamp、caller 函数名、原始 promise url，不依赖 catch 块位置
明确错误传播边界
不是所有错误都要立刻处理。有些该静默降级（如埋点上报失败），有些该终止当前流程（如鉴权失败），有些该向上冒泡（如数据格式严重错乱）。设定清晰的传播规则：
- 网络层错误（超时、断连）：自动重试 1 次 + 显示“正在重试”，不 throw 到业务层
- 业务错误（403 权限不足、422 参数校验失败）：转为特定 code，由路由或布局组件统一跳转/弹窗
- 未预期错误（JSON.parse 失败、字段缺失导致渲染 crash）：捕获后打点 + 上报原始 error.stack，不阻塞 UI
- 全局兜底：监听
unhandledrejection，记录漏网错误，防止白屏
