← 返回完整题库
Node.js困难

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()。

本题来自 计算机知识面试题库,共 921 道题。