IT 面试题库

如何用 Koa 的洋葱模型实现统一的响应包装与全局异常捕获?

中级编程题Node.js工程师后端开发工程师Koa中间件异常处理洋葱模型实践

题目

考察点:中间件工程化、错误语义、与洋葱模型的结合。实操题。

参考答案

内容深度:详细 · 含示例/代码 · 来源:外部链接 · 未复核 · 70 天前更新 · 技术内容可能随版本变化,建议结合官方文档理解

要点:

app.use(async (ctx, next) => {
  const start = Date.now()
  try {
    await next()
    if (ctx.status === 404 && !ctx.body) ctx.throw(404, '接口不存在')
    // 已返回二进制流(文件下载)时不要包装
    if (!ctx.body || ctx.body instanceof Stream) return
    ctx.body = { code: 0, message: 'ok', data: ctx.body }
  } catch (err) {
    ctx.status = err.status || 500
    ctx.body = { code: err.code || ctx.status, message: err.expose ? err.message : '服务器开小差了', data: null }
    // 5xx 记完整堆栈;4xx 只记摘要,避免日志噪音
    ctx.app.emit('error', err, ctx)
  } finally {
    ctx.set('X-Response-Time', `${Date.now() - start}ms`)
  }
})

- err.expose === true 是 Koa 对「可安全暴露给客户端」的错误标记,ctx.throw(400, '参数错误') 自动置位;未标记的(数据库报错等)必须脱敏,绝不能把堆栈吐给前端;

- 不要在包装层强改已 set 的 Content-Type(文件流、SSR 页面会坏);

- 业务友好错误建议自定义 BizError extends Error 并带 code,避免用 HTTP 500 表达业务失败;

- 顺序:统一响应/异常中间件必须放在最外层(第一个 use),日志与 trace 中间件紧随其后,路由最后。

练这道题

同分类 · 高频题

题目与答案就在本页;收藏、批注和错题重练在应用内

这道题看完了?连刷同类题,趁热打铁效果最好 进入刷题