koa 框架中,该怎么处理中间件的异常?
参考答案
处理位置
Koa 没有内置错误处理,官方推荐在最外层注册一个 try/catch 中间件做统一兜底,配合 ctx.app.emit('error') 交给全局监听。
标准实现
app.use(async (ctx, next) => {
try {
await next();
} catch (err) {
ctx.status = err.status || err.statusCode || 500;
ctx.body = { code: ctx.status, message: err.expose ? err.message : '服务器内部错误' };
ctx.app.emit('error', err, ctx); // 触发 app.on('error') 写日志
}
});
app.on('error', (err, ctx) => {
console.error('server error', err, ctx.request.url);
});
分层策略
- 业务层:主动抛出可预期的错误,用
ctx.throw(400, '参数不合法')或ctx.assert(条件, 400, 'msg')。 - 中间层:只 catch 自己能处理的,其余
throw err继续上抛。 - 最外层:统一成标准错误响应 + 日志 + 上报,区分
expose(可暴露给用户)与内部错误。 - 进程级:
process.on('uncaughtException' | 'unhandledRejection')记录并优雅退出,避免带着脏状态继续跑。
易错点
- 捕获不到没有 await 的异步任务里的异常(
setTimeout、事件回调),需要进程级兜底。 - 错误中间件必须注册在所有业务中间件之前,顺序错就捕获不到。
- 响应已经发出(
ctx.res.headersSent)时不要再改ctx.body,只能ctx.res.end()。