Koa-router忽略Mongoose的async/await，始终返回404问题排查

看起来你的问题出在Mongoose文档对象的序列化或者后续中间件的响应处理上，我来拆解一下：

首先，你提到日志里能正常打印item但返回404，这说明await Model.findById()确实拿到了数据，但Koa在处理这个响应的时候出了问题。

核心原因推测 #

1. Mongoose文档对象的序列化问题
   Mongoose的findById返回的不是普通JSON对象，而是一个Mongoose Document实例。虽然console.log能看到它的内容，但Koa在将其作为响应体返回时，会调用JSON.stringify()进行序列化。如果你的Model定义中有字段设置了select: false（默认不返回），或者Document存在循环引用，序列化后的结果可能是空对象/undefined。

2. 全局中间件的响应拦截
   如果你的Koa应用中存在类似这样的中间件：

   app.use(async (ctx, next) => {
     await next();
     if (!ctx.body || Object.keys(ctx.body).length === 0) {
       ctx.status = 404;
     }
   });
   

   当序列化后的ctx.body为空时，这个中间件会自动把状态码改成404，这就解释了为什么日志有数据但返回404。

快速解决方案 #

把Mongoose Document转换成普通JavaScript对象再赋值给ctx.body，这样Koa就能正确序列化了：

router.get('/:id', async (ctx, next) => { 
  const item = await Model.findById(ctx.params.id);
  // 转换成普通对象，也可以用item.toJSON()
  ctx.body = item ? item.toObject() : null; 
  console.log('hmm', item, ctx.response); 
});

额外排查点 #

• 检查你的Model定义，确认没有把所有字段都设置为select: false，如果需要返回特定字段，可以在查询时显式指定：

  const item = await Model.findById(ctx.params.id).select('name description');
  

• 打印ctx.response的status值，看看在设置ctx.body之后，状态码是不是被其他中间件修改了。
• 确认ctx.params.id的类型和Model中_id的类型匹配（比如_id是ObjectId还是String/Number），Mongoose虽然会自动转换，但类型不匹配可能导致查询结果异常。

内容的提问来源于stack exchange，提问作者Disorder