
工具调用失败了,外层日志却说「没有捕获到」。常见原因藏在一个 return 里:return runTool() 把 Promise 交给调用方,周围的 catch 只来得及处理调用当场抛出的异常。Promise 之后拒绝时,当前 try 已经结束。
本机用 Node.js 写了一个异步工具和两种包装函数。第一种直接返回它,第二种在返回前 await。运行记录保存在 tools/verify-agent-rejection-await-boundary.log:
node v26.8.1
async rejection without await: {"escaped":"async tool failed"}
async rejection with await: {"caught":"async tool failed"}
synchronous throw without await: {"caught":"sync tool failed"}
ASSERTIONS: all passed
return 把拒绝留给了下一层
async function runTool() {
throw new Error('tool failed');
}
async function invokeWithoutAwait() {
try {
return runTool();
} catch (error) {
return { caught: error.message };
}
}
runTool() 是 async 函数。函数体里的 throw 会让它返回一个 rejected Promise,而不是在调用表达式处同步抛出异常。invokeWithoutAwait 也会返回 Promise;这个 Promise 最终会采用 runTool() 的拒绝状态,但拒绝传递不等于经过了当前的 catch。
所以包装函数本身最后仍会拒绝。调用方若再用 await invokeWithoutAwait(),需要在自己的 try/catch 里处理它。错误没有消失,只是捕获边界比预期更外层。分发器若在这里负责生成工具错误结果,结果对象就不会由这个 catch 产生。
await 让拒绝回到当前控制流
async function invokeWithAwait() {
try {
return await runTool();
} catch (error) {
return { caught: error.message };
}
}
await 会在 Promise 拒绝时于当前 async 函数中抛出对应错误。它发生在 try 内,因此相邻的 catch 能处理它。脚本的对照结果正是如此:省略 await 时,外层观测到 escaped;加上 await 后,本层返回 caught。
这对工具执行器的区别很实际。若本层需要把异常转成 { error: ... } 这样的工具结果,捕获必须包住 Promise 的结算,而不能只包住函数调用。代码通常写成 return await executeTool(call),或者先 const result = await executeTool(call) 再组装响应。两种写法都让拒绝经过当前 catch。
同步错误仍然会被普通 catch 接住
如果工具函数在返回 Promise 之前就同步抛错,例如参数检查在普通函数里执行并抛出,try { return fn(); } catch { ... } 可以捕获它。若函数返回 Promise 后又拒绝,则必须等待拒绝发生。一个入口同时接收同步返回值和 Promise 时,return await fn() 能用同一处 catch 覆盖两类错误。
验证脚本没有接入模型、插件或真实工具协议,只检查 JavaScript 的 Promise 与异常边界。它也没有证明所有 Agent 框架都在同一层包装工具错误;不同实现可能有更外层的统一捕获。要查某个执行器,应沿着工具函数返回到结果消息构造处看 await 和 catch 的位置,不能只凭方法名猜它会接住异步拒绝。
脚本让外层分别用 .catch() 观察两种包装结果,断言一个变成 escaped、另一个变成 caught。这个观察层只负责把差别打印出来,不参与工具包装内部的捕获。若移除外层 .catch(),第一种写法会留下未处理拒绝,测试进程的表现还会受 Node.js 未处理拒绝策略影响。因此判断捕获位置时,应看包装函数返回值本身,而不要只看进程最后有没有退出。
入口若把同步抛错映射成 tool_error,却把异步拒绝留给外层,日志就会出现两种形态:一种有工具错误结果,另一种只有调用循环的异常记录。调用链看起来都失败了,历史消息却不一样。排查时可以分别用普通函数 () => { throw error } 和 async 函数 async () => { throw error } 喂给同一个包装器,观察错误最后落在哪个分支;这比只看终端报错更能确认结果构造位置。
这里我会让工具调用边界明确等待结果,再决定是返回成功值还是生成错误结果。若有意把 Promise 交给统一的上层处理器,省略 await 也可以,但那时错误契约应由上层负责。重点在于捕获错误的那一层要等到它负责的异步操作结算。