不能直接对 yield 抛出的错误码做 try-catch 动态置换,因为 yield 本身不抛异常,真正抛错的是后续调用 next()、throw() 或异步迭代时被 reject 的 promise;需通过 saga 内 try-catch、自定义 middleware、封装 safecall 或 axios 拦截器统一处理错误码。

在自定义统一防腐网关中,不能直接对 yield 抛出的错误码做 try-catch 动态置换,因为 yield 本身不抛异常,它只是暂停生成器执行并返回值;真正抛错的是后续调用 next()、throw() 或异步迭代时被 reject 的 Promise(比如 yield call(api) 失败)。关键不在“捕获 yield”,而在于拦截 generator 内部的副作用调用(如 call、put、select)所触发的失败路径,并统一转换错误码。
1. 在 saga 中用 try-catch 包裹 yield 调用链
这是最直接可控的方式:generator 函数内部对可能失败的异步操作显式加 try-catch,捕获原始错误后,再 dispatch 自定义错误 action 或 throw 封装后的错误对象。
- 例如使用 redux-saga:
function* fetchUserSaga(action) {
try {
const res = yield call(api.getUser, action.payload);
yield put({ type: 'FETCH_USER_SUCCESS', payload: res });
} catch (err) {
// 动态映射原始 err.code 或 err.response?.status
const mappedCode = mapErrorCode(err);
yield put({
type: 'FETCH_USER_FAIL',
payload: { code: mappedCode, message: err.message }
});
}
}mapErrorCode 可以查表、走配置中心、或根据 HTTP 状态码/业务字段做多级判断,实现“动态置换”。
2. 使用 saga middleware 拦截所有失败的 effect
通过自定义 saga middleware,在 effect 执行失败时统一介入。需 patch redux-saga 的 runEffect 或利用 setContext + getContext 注入错误处理器。
- 推荐方式:在根 saga 中注入全局错误处理策略
- 所有子 saga 通过
yield getContext('errorMapper')获取映射函数,避免硬编码 - 适用于需要跨多个 saga 共享同一套错误码规范的场景
3. 封装 call effect,内置错误码转换逻辑
不直接 yield call(...),而是 yield 封装后的 safeCall,由它负责捕获异常并重抛标准化错误。
- 示例:
function safeCall(fn, ...args) {
return call(function* () {
try {
return yield call(fn, ...args);
} catch (err) {
throw new StandardError({
code: mapErrorCode(err),
original: err
});
}
});
}
<p>// 使用
const data = yield safeCall(api.getOrder, orderId); // 错误已被转换</p>这样业务 saga 保持简洁,错误处理下沉到工具层,也便于单元测试和替换策略。
4. 配合 axios 拦截器做前置标准化(推荐组合使用)
如果错误源头是 HTTP 请求,优先在请求库层面统一处理:用 axios response interceptor 将后端原始错误码转为前端约定结构,再透传给 saga。这样 yield call 得到的 err 已是“置换后”的,saga 层只需关注业务语义,无需重复解析。
- 例如后端返回 { code: 500201, msg: "token expired" },拦截器转成 { code: 'AUTH_TOKEN_EXPIRED', status: 401 }
- saga 中直接 switch(code) 即可,无需每次解析字符串或数字











