async/await异步函数抛出错误无法被React调用处捕获的问题
问题本质是内部异步操作的错误没有和外层async函数的返回Promise建立绑定,和React组件的捕获逻辑无关。
常见代码误区
未通过
return/await接入链路的独立Promise,和外层async函数完全脱节
async函数仅会捕获两类错误:- 函数执行栈内同步抛出的错误
- 被
await的Promise触发的reject值
所有未被await、未被纳入函数返回值链路的Promise,无论resolve还是reject,都不会改变外层async函数的返回状态。比如原代码else分支里写的
Promise.reject("Already Exists!")没有被return,相当于async函数执行到这步直接运行结束,返回一个值为undefined的resolve状态Promise,这个游离的reject因为没有监听者,只会在控制台触发未处理Promise拒绝警告,根本无法传递到组件的catch回调。catch回调中创建的reject未向上传递
原代码在add.commit().catch(...)回调里写的Promise.reject("Unknown error occurred"),是在这个独立Promise的处理回调中新建的游离Promise,既没有被return,也没有被throw,和addUser的返回值链路没有任何关联。同时因为catch回调已经处理完add.commit的错误,这条独立链式Promise已经切换为resolve状态,外层调用自然收不到任何错误信号。这也是之前尝试用
throw抛出错误依然无法捕获的原因:如果throw语句写在add.commit的catch回调里,这个throw属于独立Promise的处理执行栈,不在addUser的async执行流程内,自然无法被外层的catch捕获。
代码修正方案
把所有错误传递链路接入addUser本身的async执行流,不需要创建游离的Promise对象:
export const addUser = async (details, code) => { const isExist = await isUser(code); if (!isExist) { const add = db.batch(); add.set(userID(code), details); try { // 直接await commit操作,让其reject自动冒泡到外层async函数 await add.commit(); } catch (e) { console.log(e); // 在catch回调中直接throw,错误会被async函数自动包装为返回Promise的reject值 throw "Unknown error occurred"; } } else { // 同步throw即可,async函数会自动将同步抛出的错误转换为返回Promise的reject状态 throw "Already Exists!"; } };
修正后的运行逻辑
调整后的addUser会返回明确状态的Promise:
- 全流程操作成功时,返回resolve状态的Promise,组件端的
.then()会正常触发路由跳转 - 任意环节抛出错误(包括手动自定义错误、Firebase操作原生错误)时,返回reject状态的Promise,组件端的
.catch()会正常接收到错误值,执行setError逻辑。
关键提醒:不要在async函数内创建没有被return/await的游离reject或throw,这类错误永远不会被外部调用链路捕获。
内容的提问来源于stack exchange,提问作者Shreyas Jadhav

