koa2中间件不await next()会导致错误无法被捕获，因为next()返回promise，漏await会使后续逻辑脱离try/catch，触发unhandledrejection；需全局监听并逐个检查条件分支、旧写法、第三方中间件及提前响应场景。
为什么 Koa2 中间件不 await 就会炸？
因为 Koa 的中间件链是基于 Promise 的，next() 返回一个 Promise；如果不 await next()，后续逻辑就脱离了当前中间件的 try/catch 作用域，一旦下游抛错，就会变成未处理的 Promise rejection，最终触发 process.on('unhandledRejection') —— 这时 Koa 的错误中间件根本捕获不到，Node 进程可能直接退出或返回空白 500。
如何快速定位没 await 的中间件？
常见症状：接口偶发 500、日志里看不到错误堆栈、console.error 没输出、但终端突然打印 UnhandledPromiseRejectionWarning。重点检查以下几类代码：
- 所有含
next()调用的中间件，尤其是带条件分支的（比如 if/else 里只在某个分支写了await next()） - 使用了
return next()或next().then(...)的旧写法（Koa2 不推荐，容易漏 catch） - 第三方中间件文档没写清是否需要 await（例如某些 logger 或 auth 中间件）
-
ctx.body = await someAsyncFn()后忘了await next()（常见于提前响应后还想继续执行）
修复写法：必须保证每个 next() 都被 await
正确模板只有一个：await next() 必须出现在 try 块内、且不能被任何条件跳过。错误示例和修正对比：
/* ❌ 错误：if 分支外漏掉 await */
app.use(async (ctx, next) => {
if (ctx.path === '/health') {
ctx.body = 'OK';
return; // 这里没 await next()，但 next() 实际没被调用 —— OK
}
// ⚠️ 问题在这里：else 分支没显式 await，next() 被忽略！
next(); // 漏 await → 后续异常无法捕获
});
<p>/<em> ✅ 正确：所有路径都确保 await next() </em>/
app.use(async (ctx, next) => {
if (ctx.path === '/health') {
ctx.body = 'OK';
return;
}
await next(); // 即使不走下游，也显式 await（它会 resolve 立即）<br>
});</p>
加一层防御：全局兜底监听 unhandledRejection
即使你自认为写全了 await，依赖库或未来新增代码仍可能出错。务必在 app.js 最顶部加：
process.on('unhandledRejection', (reason, promise) => {
console.error('Unhandled Rejection at:', promise, 'reason:', reason);
// 可选：记录到日志文件、触发告警，但不要在这里 res.send —— ctx 已不可用
});
<p>process.on('uncaughtException', (err) => {
console.error('Uncaught Exception:', err);
process.exit(1); // 防止僵尸进程
});</p>
注意：unhandledRejection 监听器不能替代 Koa 错误中间件，它只是最后一道防线；真正要命的是——它出现时，说明你的中间件链已经失控，必须回溯找漏 await 的地方。
